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allow clients in a distributed computing environment 
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TITLE: METHOD AND APPARATUS TO OBTAIN SERVICE CAPABILITY CREDENTIALS 

BACKGROUND OF THE INVENTION 

5 

1. Field of the Invention 

This invention relates to distributed computing environments including Web-centric and Internet-centric 
distributed computing environments, and more particularly to a heterogeneous distributed computing environment 
based upon a message passing model for connecting network clients and services, and the discovery of services in 
10 such an environment 

2. Description of ihe Related Art 

Intelligent devices are becoming mcreasingry common. Such devices range from smart appliances, 
personal digital assistants (PDAs), cell phones, lap top computers, desktop computers, workstations, mainframes; 
15 even, super computers. Networks are also becoming an increasingly common way to interconnect intelligent 
devices so that they may communicate with one another. However, there'may be large differences in the computing 
power and storage capabilities of various intelligent devices. Devices with more limited capabilities may be referred 
to as small footprint devices or "thin" devices. Thin devices may not be able to participate in networks 
mtercormecting more capable devices. However, it may still be desirable to mterconnect a wide variety of differs 
20 types of intelligent devices. 

The desire to improve networking capabilities is ever increasmg. Business networks are expanding to 
include direct interaction with suppliers and customers. Cellular phones, personal digital assistants and Internet- 
enabled computers are commonplace in both business and the home. Home networks are available for 
mterconnecting audio/visual equipment such as televisions and stereo equipment to home computers, and other 
25 devices to control intelligent systems such as security systems and tenmerature control thermostats. High bandwidth 
mediums such as cable and ASDL enable improved services such as Internet access video on demand, e-commerce, 
etc. Network systems are becoming pervasive. Even without a formal network, it is still desirable for intelligent 
devices to be able to communicate with each other and share resources. 

Currently, traditional networks are complex to set up, expand and manage. For example, adding hardware 
30 or software to a network often requires a network administrator to load drivers and configure systems. Making 
small changes to a network configuration may require mat the entire network be brought down for a period. In 
addition, certain intelligent devices may not support the necessary interfeces to communicate on a given network. 

What is needed is a simple way to connect various types of intelligent devices to allow for communication 
and sharing of resources while avoiding the mteroperabiliry and complex configuration problems existing in 
35 : conventional networks. Various technologies exist for inmroving the addition of devices to a network. For 
example, many modem I/O buses, such as the Universal Serial Bus, 1394 and PCI, support plug and play or 
dynamic discovery protocols to simplify the addition of a new device on the bus. However, these solutions are 
limited to specific peripheral buses and are not suitable for general networks. 

A more recent technology, Jini from Sun Microsystems, Inc., seeks to simplify the connection and sharing 
40 of devices such as printers and disk drives on a network. A device that incorporates Jini may announce itself to the 
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network, may provide some details about its capabilities, and may immediately become accessible to other devices 
on the network. Jini allows for distributed computing where the capabilities of the various devices are shared on a 
network. The Jini technology seeks to enable users to share services and resources over a network. Another goal of 
the Jini technology is to provide users with easy access to resources anywhere on the network while allowing the 
5 network location of the user to change. Jini also seeks to simplify the task of building, maintaining and altering a 
network of devices, software and users. 

Jini requires that each Jini enabled device have a certain amount of memory and processing power. 
Typically, a Jini enabled device is equipped with a Java Virtual Machine (JVM). Thus, Jini systems are Java 
technology centered. Java is a high level object oriented programming language developed by Sun Microsystems, 
10 Inc. Java source code may be compiled into a format called bytecode, which may then be executed by a Java 
Virtual Machine. 

Bytecode is computer source code that is processed by a virtual niachme, rather than the "real' 1 computer 
machine, the hardware processor. The virtual machine converts generalized machine instruction (the bytecode) into 
specific machine instructions (instructions that the computer's processor will understand). Using a language mat 
15 comes with a virtual machine for each platform, the source language statements may be compiled only once and may 
then run on any platform that supports the virtual machine. The Java programming language is an example of such a 
language, and the Java Virtual Machine (JVM) is an example of a virtual machine platform that supports programs 
written in the Java programming language. 

Since Java Virtual Machines may be provided for most computing platforms, Java and thus Jini provide 
20 for a certain amount of platform independence. The Jini architecture leverages off the assumption that the Java 
programming language is the implementation language for the components of the Jini system. The ability to 
dynamically download and run Java code is central to marry features of the Jini architecture. 

The purpose of the Jini architecture is to federate groups of devices and software components into a single 
dynamic distributed system. A key concept within the Jini architecture is mat of a service. A service is an entity 
25 that can be used by a person, a program, or another service. Two examples of services are printing a document and 
translating from one word processor format to another. Jini allows the members of a Jini system to share access to 
services. Services in a Jini system communicate with each other by using a service protocol, which is a set of 
interfaces written in the Java programming language. Services are found and resolved in a Jini system by a look-up 
service. A look-up service maps interfaces indicating the functionality provided by a service to sets of objects that 
30 implement the service. 

Descriptive entries may also be associated with a service. Devices and applications use a process known as 
discovery to register with the Jini network. Once registered, the device or application places itself in the look-up 
service. The look-up service may store not only pointers to these services on the network, but also may store the 
code for accessing these services. For example, when a printer registers with the look-up service, it loads its printer 
35 driver and/or an interface to the driver into the look-up service. When a client wants to use the printer, the driver 
and driver interface are downloaded from the look-up service to the client this code mobility means that clients 
can take advantage of services from the network without pre-installing or loading drivers or omer software. 

Communication between services in a Jini system is accomplished using the Java Remote Method 
• Invocation (RMI). RMI is a Java programming language enabled extension- to traditional remote procedure call 
40 mechanisms. RMI allows not only data to be passed from object to object around the Jini network, but full objects 
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including code as well Jini systems depend upon this ability to move code around the network in a form that is 
encapsulated as a Java object 

Access to services in a Jini system is lease based. A lease is a grant of guaranteed access over a time. Each 
lease is negotiated between the user of the service and the provider of the service as part of the service protocol A 
5 service may be requested for some period and access may be granted for some period presumably considering the 
request period. Leases must be renewed for a service to remain part of the Jini system. 

Figure 1 illustrates the basic Jini technology stack. The Jini technology defines a distributed prograrnming 
model 12 (supported by JavaSpaces, leases, and object templates). Object communication in Jini is based on an 
RM1 layer 14 over a TCP/IP capable networking layer 16. 
10 Jini is a promising technology for simplifying distributed computing. However, for certain types of 

devices, Jini may not be appropriate. The computing landscape is moving toward a distributed, Web-centric service 
and content model where the composition of client services and content changes rapidly. The client of the future 
may be a companion type device that users take with them wherever they go. Such a device may be a combination 
of a cell phone and a PDA for example. It would be desirable for such devices to be able to communicate and share 
15 resources with devices that are more powerful, as well as with thinner or less powerful devices. 

In addition, with the advent of the Internet and resulting explosion of devices connected to the net, a 
distributed programming model designed to leverage this phenomenon is needed. An enabling technology is needed 
mat facilitates clients connecting to services in a reliable and secure fashion. Various clients from thick to thin and 
services need to be connected over the Internet, corporate Internets, or even within single computers. It is desirable 
20 to abstract the distance, latency and implementation from bom clients and services. 

The key challenge for distributed computing technology is to be scalable from powerful thick clients down 
to very thin clients such as embedded mobile devices. Current distributed computing technologies, such as Jini, may 
not be scalable enough for the needs of all types of clients. Some devices, such as small footprint devices or 
embedded devices, may lack sufficient memory resources and/or lack sufficient networking bandwidth to participate 
25 satisfactorily in current distributed computing technologies. Hie low end of the client spectrum, including 
embedded mobile devices, often have limited or fixed code execution environments. These devices also may have 
minimal or no persistent storage capabilities. Most small, embedded mobile devices do not support a Java Virtual 
Machine. Most code-capable small clients run native code only. In addition, most small devices have little more 
than flash memory or battery backed RAM as their sole persistent storage media. The size of the storage is often 
30 very small and sometimes read-only in nature. Furthermore, the access time of this type of storage media is often an 
order of magnitude greater than hard disk access time in clients that are more powerful. 

Existing connection technologies, such as Jini, may not be as scalable as desired because they are too big. 
For example, Jini requires that all participants support Java; however, many small clients may not have the resources 
for a Java Virtual Machine. Furthermore, due to its use of RMI, Jini requires mat clients be able to download code 
35 and content Jini may augment the existing client platform by downloading new classes, which may pose security 
and size concerns for small devices such as embedded devices. Jini works by clients and resources communicating 
bypassing code and data. When a client activates a Jini service, the service may return its results to the client, 
which may include a large amount of code or content In Jini, a client may call a method and a large object may be 
returned, and thus downloaded. The client may not have the resource to accept me ietumed object In addition, 
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RMI and Java itself require a lot of memory. Many small foot print devices may not have the resources to 
participate effectively or at all in current distributed confuting technologies. 

Another concern with existing distributed computing technologies is that they often require certain levels of 
connection capability and protocols. For example, Jini assumes the existence of a network of reasonable speed for 
5 connecting computers and devices. Jini also requires devices to support TCP/IP network transport protocol 
However, many smaller devices may have limited connection capabilities. Small devices may have high latency or 
low speed network connections and may not support TCP/IP. 

As mentioned above, Jini requires devices to support Java and thus include a Java Virtual Machine, which 
requires a certain amount of processing and storage capabilities that might not be present for many small devices. 
10 This also restricts the flexibility of Jini in that non-Java devices may not directly participate in a Jini system. Since 
Jini requires Java, it may be deemed a homogenous environment However, it is desirable to have a distributed 
computing facility for heterogeneous distributed computing that scales from extremely small embedded devices 
through PDA's and cell phones to laptops and beyond even to the most powerful computers. 

Other heterogeneous solutions exist, such as the Common Object Request Broker Architecture (CORBA). 
15 CORBA is an arclutecture that enables program objects to communicate with one another regardless of the 
prograniming language they were written in or what operating system they're running on. However, CORBA does 
not address all of the connection issues that are addressed by Jini. In addition, CORBA suffers from similar 
scalability problems as Jini 

Technology such as Jini and CORBA use a code-centric programming model to define the interface 
20 between remote components. A code-centric programming model defines programmatic interlaces or API's for 
communication between remote clients or components. The APFs may be defined in a particular programming 
language. The API's must be agreed to by all software components to ensure proper interoperability. Since all 
access to components is through these standards API's, the code that implements these API's must be present in the 
client platform. The code may be statically linked into the platform or dynamically downloaded when needed. 
25 Many embedded or mobile devices simply cannot accept code dynamically from a network due to the quality control 
issues involved as well as the reliance on a single language and program execution environment Data-centric 
models, such as networking protocols, may avoid the dependence on moving code; however, such protocols are not 
rich enough to easily provide for distributed computing and they also lack the ease of programming with code and 
other prograniming features, such as type safety. 
30 Conventional distributed computing systems rely on the ability of a program executing on a first device to 

be able to remotely call a program on a second device and have the results returned to the first device. The Remote 
Procedure Call (RPC) is a basic mechanism for remotely calling a program or procedure. CORBA and Jini are both 
based on the ability to remotely invoke program methods. However, communicating by passing code or objects, 
such as in Jini or CORBA, may be somewhat complex. For example, as mentioned above, Jini uses the Java Remote 
35 Method Invocation (RMI) to communicate between services. In order for a client to move Java objects to and from 
remote locations, some means of serialization/deserialization is needed. Such current facilities in the Java 
Development Kit (JDK) rely upon the reflection API to deterrriine me content of a Java object, and ultimately that 
code must consult the Virtual Machine. This code is quite large and inefficient 

The fundamental problems with the current "method for doing serializanWdeserialization include its size, 
40 speed, and object traversal model Code outside the JVM does not know the stracture or graph of a Java object and 
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thus must traverse the object graph, pulling it apart, and ultimately must call upon the JVM. Traditional 
serialization and reflection mechanisms for storing and moving Java objects are just not practical for all types of 
devices, especially thinner devices. Some of the difficulties with Java reflection and serialization are that an 
object's graph (ah object's transitive closure) reflection is difficult to do outside the JVM Serialization is too large, 
5 requiring a large amount of code. In addition, serialization is a Java specific object interchange format and thus may 
not be used with non-Java devices. 

The Jini distributed computing model requires the movement of Java objects between Java devices. Thus, 
the serialization mechanism itself is not platform independent since it may not be used by non-Java platforms to 
send and receive objects. Serialization is a homogenous object format - it only works on Java platforms. 
10 Serialization uses the reflection API and may be limited by security concerns, which often must be addressed using 
native JVM dependent methods. The reflection API may provide a graph of objects, but is inefficient due to the 
number of calls between the JVM and the code calling the reflection methods. 

The use of Java reflection to serialize an object requires an application to ping pong in and out of the JVM 
to pick apart an object one field at a time as the transitive closure of the object is dynamically analyzed. 
15 Deserializing an object using Java deserialization requires the application to work closely with the JVM to 
reconstitute the object one field at a time as the transitive closure of the object is dynamically analyzed. Thus, Java 
serialization/deserialization is slow and cumbersome while also requiring large amounts of application and JVM 
code as well as persistent storage space. 

Even for thin clients that do support Java, the Jini RMI may not be practical for thin clients with minima] 
20 memory footprints and minimal bandwidth. The serialization associated with the Jini RMI is slow, big, requires the 
JVM reflection API, and is a Java specific object representation- Java deserialization is also slow, big and requires 
. a serialized-object parser. Even Java based thin clients may not be able to accept huge Java objects (along with 
needed classes) being returned (necessarily) across the network to the client as required in Jini A more scalable 
distributed computing mechanism is needed. It may be desirable for a more scalable distributed computing 
25 mechanism to address security concerns and be expandable to allow for the passing of objects, such as Java objects, 
and even to allow for process migration from one network mode to another. 

Object based distributed computing systems need persistent storage. However, as discussed above, 
attempts at object storage are often language and operating system specific. In addition, these object storage 
systems are too complicated to be used with many small, embedded systems. For example, the Jini technology uses 
30 JavaSpaces as persistent object containers. However, a JavaSpace can only store Java objects and cannot be 
implemented in small devices. Each object in a JavaSpace is serialized and pays the above^escribed penalties 
associated with Java serialization. It may be desirable to have a heterogeneous object repository for distributed 
computing that may scale from small to large devices. 

JavaSpaces from Sun Microsystems, Inc., draws from the parallel processing work of David Gelernter, a 
35 computer science professor at Yale University. Gelernter 3 s set of functions named "Linda" create a shared memory 
space called a TupleSpace, in which results of a computer' s processes or the processes themselves may be stored for 
access by multiple CPUs. Linda therefore provides a global shared memory for multiple processors. 

Another technology which extends Linda is TSpaces from IBM Corporation. TSpaces extends the basic 
Linda TupleSpace framework with real data management and the ability to download new data types and new 
40 semantic functionality. TSpaces provides a set of network communication buffers and a set of APIs for accessing 
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those buffers. Like many of the solutions discussed above, TSpaces therefore uses a code-centric programming 
model and shares the drawbacks of such a model. Additionally, TSpaces is implemented in the Java programming 
language and therefore requires a Java Virtual Machine or other means of executing Java bytecode, such as a Java- 
capable microprocessor. Therefore, TSpaces may be inappropriate for small-footprint devices which cannot devote 
5 . sufficient resources for executing Java bytecode. 

It is desirable in object oriented distributed systems to be able to locate object repositories and find 
particular objects within those repositories. As mentioned above, the Jini look-up server may not be practical for 
small devices with small memory footprints. A more efficient mechanism for locating object stores may be 
desirable. 

10 It may be desirable in a distributed network computing model for clients to have the ability to locate 

services. Current network protocols either provide only a single standard service access interface that provides no 
security when accessing a network service or provides u all or nothing" access to the full range of the service's 
capabilities, which may include administrator or privileged functions. Also, current network protocols to locate 
services do not provide a flexible mechanism for finding services. Current protocols either do not provide any 

15 selective search capability at all (e.g. UPnP) or only provide a primitive keyword and attribute grammar mechanism 
(e.g. SLP). Thus, current service discovery mechanism may be too inflexible m their security and search criteria 
mechanisms. 

Also, current service discovery models have a symmetric model for service location. However, it may be a 
waste of resources for certain service devices, such as devices whose functionality is available on a proximity basis, 
20 to support the discovery model. This is because such devices are already located by proximity (e.g. one device 
physically pointing to another one). Thus, an alternate light-weight discovery mechanism may also be desirable for 
such devices. 

Distributed object access also desires a fair and efficient sharing mechanism. As described above Jini 
currently uses a leasing mechanism to share objects. However, Jini leases are time based which may result in a 

25 number of problems. For example, the current object holder might have no idea how long to lease an object and 
may hold it too long. In addition, the use of time-based leases may require that time be synchronized between 
multiple machines. Moreover time based leasing may require operating system support In addition, Jini leases are 
established arid released via RML Thus, the Jini leasing mechanism suffers from the above-noted problems with 
using RML In addition, the Jini leasing mechanism does not provide a security mechanism for establishing, 

30 renewing and canceling of leases. Other leasing mechanisms may be desirable. 

Generally speaking, it is desirable for small memory foot print mobile client devices to be able to run a 
variety of services, both legacy and new, in a distributed environment The types of small clients may include cell 
phones and PDA's with a variety of different networking interfaces, typically low bandwidth. Often these devices 
have very small displays with limited graphics, but they could include laptops and notebook computers, which may 

35 have a larger display and more sophisticated graphics capabilities. The services may be a wide range of applications 
as well as control programs for devices such as printers. It is desirable for a mobile client to be able to use these 
services wherever they may be. 

A mobile client will often be at a temporary dynamic network address, so networking messages it sends 
cannot be routed beyond that networking interface (otherwise there may be collisions when two different clients on 

40 different networks have the same dynamic address). Mobile clients often do not have the capability for a full 
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function browser or other sophisticated software. The displays may limit the client from rumiing certain 
applications. Traditional application models are based on predetermined user interfece or data characteristics. Any 
change to the application requires recompilation of the application. 

It may be desirable for such clients to have a mechanism for finding and invoking distributed applications 
5 or services. The client may need to run even large legacy appUcations wmch could not r^fcry fit in the cUent's 
memory footprint As discussed above, current technology, such as Jini, may not be practical for small footprint 
devices. The pervasiveness of mobOe thin cUents may also raise additional needs. For example, it may be desirable 
to locate services based on the physical location of the user and his mobile client For example, information about 
the services in a local vicinity may be very helpful, such as local restaurants, weather, traffic maps and movie 
10 information. Similarly, information about computing resources, such as printers in a particular location, may be 
helpfuL Current technologies do not provide an automatic mechanism for locating services based on physical 
location of me cUerit Another need i^is^ Thki 
mobile clients typically do not contain ergonomic keyboards and monitors. The provision of such human factor 
services and/or the ability to locate such services in a distributed computing environment may be desirable. 
15 A distributed computing model should provide clients with a way to find transient documents and services. 

It may be desirable to have a mechanism for finding general-purpose documents (including services and/or service 
advertisements), where the documents are expressed in a platform-independent and language-independent typing 
such as that provided by extensible Markup Language (XML). Current approaches, including lookup mechanisms 
for Jini, Universal Plug and Play (UPnP), and the Service Location Protocol (SLP), do not support such a general- 
20 purpose document lookup mechanism. For example, the Jini lookup mechanism is limited to Java Language typing 
* and is therefore not language-independent UPnP and SLP support a discovery protocol only for services, not for 
general-purpose documents. 

SUMMARY 

In a distributed computing environment, a service discovery protocol may allow clients to search for 
25 services (both space services and specific services or types of services). Service providers (or a listener agent) may 
respond to search requests by publishing or providing corresponding advertisements or URIs to corresponding 
advertisements. When a service provider responds to a discovery search request (either directry or through a listener 
agent), the provider may choose to publish a protected or an unprotected (complete) advertisement A protected 
advertisement may include the set of information necessary to obtain a complete advertisement Publishing a 

30 protected advertisement, forces the client to the obtain a valid credential from an authentication service before 
receiving the complete unprotected advertisement from the service provider. A complete un-protected 
advertisement is needed to create a gate, and therefore to use the service. Forcing clients to obtain a valid credential 
before receiving an advertisement may provide an additional level of security for the service pnrvider. The security 
credential mat must be obtained to receive the complete advertisement may be the same security credential mat is 

35 used to construct a gate to communicate with the service where the gate embeds the security credential in each 
message to the service. 

To obtain a complete advertisement, given a protected advertisement, a client obtains a capability 
credential from the specified authentication service by sending a credential request message. The credential request 
message may be sent to an authenticated service URI specified in the advertisement for the service the client desires 
40 t0 access, when the client's request is received, a capability credential is generated. The capability credential may 
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be generated according to capabilities requested by the client and/or the client's level of authorization. The client 
then receives the capability credential in response to its request The response may contain the credential needed to 
generate the complete advertisement This credential may be the same credential that the client's gate includes in 
each message sent to the service. If the advertisement was a protected advertisement, the client then may send an 
5 advertisement request message containing the capability credential and an identification (e.g. UU1D) of the service 
to the second URI specified in the protected advertisement The client then receives a complete advertisement The 
response to this second message is the complete advertisement of the specified service. The complete advertisement 
and the capability credential may then be used to create a gate used to a>nmiumcate vWth the service. 

In one embodiment, a method for accessing a service in a distributed computing environment may include a 
10 client locating a first service within the distributed computing environment To locate services, the client may send 
a search message in a data representational language. The search message may include search criteria, such as 
service name and service type criteria. Services or a listener agent receiving the search message may compare the 
search criteria to service advertisements to find advertisements mat match the search criteria. Service 
advertisements may be data representational language documents that provide access information for corresponding 
15 services. The client may then receive search response messages which indicate advertisements that matched the 
search criteria. 

The client may then select a service that is desired to be accessed and request a capability credential to 
allow the client to access some or all of that services capabilities. Hie client may send a capability credential 
request message to a URI specified in the selected service advertisement This URI may be for an authentication 
20 service. If the advertisement was a complete advertisemem mcmdmg schema inforrr^ 

service, then the client may receive a capability credential for accessing the services complete capabilities. If the 
advertisement was a protected advertisement which does not include access schema infoimanon, then the client may 
include within its capability credential request message an indication of a set of desired capabilities for which it 
desires permission to access from the service. 
25 A client then receives the capability credential which indicates that the client is allowed to access at least a 

portion ofme services capabilities. The capabilities for which the client is allowed access maybe the lesser of the 
set of capabilities which the client requested in its capability credential request message and the set of capabilities 
for which the client is authorized If the original advertisement indicated in the response to the clients search 
. message was not a complete advertisement, the client then uses the capability credential to request a complete 
30 advertisement for its granted capabilities. The client may send a advertisement request message to a URI specified 
in the protected advertisement A service provider receiving the advertisement request message may generate a 
custom complete advertisement for the capabilities indicated by the clients capability credential and return this 
complete advertisement to the client The client may then construct a message gate based on the complete 
advertisement for sending messages according to the schema in the complete advertisement to access the services 
35 capabilities. The gate may include the capability credential in each message so that its messages may be 
authenticated by the service. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is an illustration of a conventional distributed computing technology stack; 
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Figure 2 is an illustration of a distributed computing environment projgramming model according to one 
embodiment; 

Figure 3 is an illustration of messaging and networking layers for a distributed computing environment 
according to one embodiment; 

5 Figure 4 is an illustration of a discovery service for finding spaces advertising objects or services in a 

distributed computing environment according to one embodiment; 

Figure 5 illustrates client profiles supporting static and formatted messages for a distributed computing 
environment according to one embodiment; 

Figure 6 is an illustration of a distributed computing model employing XML messaging according to one 
10 embodiment; 

Figure 7 illustrates a platform independent distributing computing environment according to one 
embodiment; 

Figure 8 is an illustration of a distributed computing model in which services are advertised in spaces 
according to one embodiment; 

1 5 Figure 9 is an illustration of a distributed computing model in which results are stored in spaces according 

to one embodiment; 

Figure 10 is an illustration of client and service gates as messaging endpoints in a distributed computing 
model according to one embodiment; 

Figure 10b is an illustration a message endpoint generation according to a schema for accessing a service 
20 according to one embodiment 

Figure 11a illustrates gate creation in a distributed computing environment according to one embodiment; 
Figure 1 lb illustrates gate creation and gate pairs in a distributed computing environment according to one 
embodiment; 

Figure 12 is an illustration of possible gate components in a distributed computing environment according 
25 to one embodiment; 

Figure 13 is an illustration of proxy client for a conventional browser to participate in the distributed 
computing environment according to one embodiment; 

Figure 14 illustrates the use of a method gate to provide a remote method invocation intermce to a service 
in a distributed computing environment according to one embodiment; 
30 Figure 15 is an illustration of the use of a space in a distributed computing environment according to one 

embodiment; 

Figure 16 illustrates advertisement structure according to one embodiment; 

Figure 17 illustrates one example of advertisement state transitions that an advertisement may undergo 
during its lifetime according to one embodiment; 
35 Figure 18 is an illustration various space location mechanisms in a distributed computing environment 

according to one embodiment; . 

Figure 19 is an illustration of space federations in a distributed cxmiputing environment according to one 
embodiment; 

Figure 20 is a flow diagram illustrating client formation of a session with a space service in a distributed 
40 computing environment according to one emrxxtiment; 
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Figure 21 is an illustration of a space event type hierarchy for one embodiment; 

Figure 22 is a flow diagram fflustrating service instantiation in a distributed computing environment 
according to one embodiment; 

Figure 23 is an illustration of a default space in a distributed computing environment according to one 

5 embodiment; 

Figure 24 illustrates an example of a device bridging proximity-based devices onto another transport 
mechanism to allow the services provided by the proximity-based devices to be accessed by devices outside the 
proximity range of the devices, according to one embodiment; 

Figure 25 is an illustration of the use of lease renewal messages in a distributed computing environment 
10 according to one embodiment; 

Figure 26a is a flow diagram illustrating an authentication service im>viding an authenticarion credential to 

a client according to one embodiment; 

Figure 26b is a flow diagram expanding on step 1002 of Figure 26a and illustrating an authentication 
service generating an authentication credential according to one embodiment; 
15 Figure 27 illustrates one embodiment of a bridging mechanism; 

Figure 28 illustrates an example of a space discovery protocol mapped to an external discovery , service 

according to one embodiment; 

Figure 29 illustrates bridging a client external to the distributed computing environment to a space in the 
distributed computing environment according to one embodiment; 
20 Figure 30 is an illustration of a proxy mechanism according to one embodiment; 

Figure31 illustrates one embodiment ofa client with an associateddisplay and display service accon^g to 
one embodiment; 

Figures 32A and 32B illustrate examples of using schemas of dynamic display objects according to one 
embodiment; 

25 Figure 33 A illustrates a typical string representation in the C prog rammin g language; 

Figure 33B illustrates an example of a <x>nvenn^nal strmg function; 

Figure 33C illustrates an efficient method for representing and managing strings in general, and in small 
footprint systems such as embedded systems in particular according to one embodiment; 

Figure 34 illustrates a process of moving objects between a client and a service according to one 
30 embodiment; 

Figures 35a and 35b are data flow diagrams illustrating embodiments where a virtual machine (e.g. JVM) 
includes extensions for compiling objects (e. & Java Objects) into XML representations of the objects, and for 
decompiling XML representations of (Java) objects into (Java) objects; 

Figure 36 illustrates a client and a service accessing store mechanisms in the distributed cornputmg 
35 environment, according to one embodiment; 

Figure 37 illustrates process migration using an XML representation of the state of a process, according to 

one embodiment; ' 

Figure 38 illustrates a mobile client device accessing spaces in a local distributed computing network, 
according to one embodiment; 
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Figure 39a illustrates a user of a mobile device discovering the location of docking stations, according to 
one embodiment; 

Figure 39b illustrates a mobile client device connecting to a docking station, according to one embodiment; 

Figure 40a illustrates an embodiment of embedded devices controlled by a control system and accessible 
5 wra^ me distrmuted compute 

Figure 40b illustrates a device control system connected via a network (e.g. the Internet) to embedded 
devices accessible within the distributed computing environment, according to one embodiment; 

Figure 4 1 is a flow chart illustrating service discovery according to one embodiment; 

Figure 42 is a flow chart illustrating an example of locating service advertisements according to one 
10 embodiment; 

Figure 43 is an illustration compares the difference in the discover process when the published 
advertisement is a complete advertisement versus a protected advertisement, according to one embodiment; 

Figure 44 is a block diagram of an example of a system in which a client device directly discovers a service 
on a service device over a proximity link, according to one embodiment; and 
15 Figure 45 is a basic flow diagram illustrating client discovery of a proximity service, according to one 

embodiment 

While the invention is susceptible to various modifications and alternative forms, specific embodiments 
thereof are shown by way of example in the drawings and will herein be described in detail. It should be 
understood, however, that the drawings and detailed description thereto are not intended to limit the invention to the 
20 particular form disclosed, but on the contrary, the intention is to cover all modifications, equivalents and alternatives 
felling within the spirit and scope of the present invention. 

DETAILED DESCRIPTION OF EMBODIMENTS OF THE INVENTION 

25 Overview of Embodiments for Distributed Computing 

Turning now to Figure 2, a distributed computing environment programming model is illustrated. The 
model includes API layer 102 for racilitating distributed computing. Hie API layer 102 provides an interface that 
facilitates clients connecting to services. The API layer 102 is concerned with the discovery of and the connecting 
of clients and services. The API layer 102 provides send message and receive message capabilities. This messaging 

30 API may provide an interface for simple messages in a representation data or meta-data format, such as in the 
extensible Mark-up Language (XML). Note that while embodiments are described herein employing XML, other 
meta-data type languages or formats may be used in alternate embodiments. In some embodiments, the API layer 
may also provide an interface for messages to conmiunicate between objects or pass objects, such as Java objects, 
API's may be provided to discover an object repository or "space", find a particular object, claim and release an 

35 object, and write or take an object to or from the object repository. Objects accessible through API layer 102 may 
be represented by a representation data format, such as XML. Thus, an XML representation of an object may be 
manipulated, as opposed to the object itself 

API layer 102 sits on top of a messaging layer 104. The messaging layer 104 is based on a representation 
data format, such as XML, In one embodiment, XML messages are generated by messaging layer 104 according to 

40 caDs to the API layer 102. The messaging layer 104 may provide defined static messages that may be sent between 
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clients and services. Messaging layer 104 may also provide for dynamically generated messages. In one 
embodiment, an object, such as a Java object, may be dynamically converted into an XML representation. The 
messaging layer 104 may then send the XML object representation as a message. Conversely, the messaging layer 
104 may receive an XML representation of an object The object may then be reconstituted from that message. 

5 In one embodiment, messages sent by messaging layer 104 may include several basic elements, such as an 

address, authentication credentials, security tokens, and a message body. The message system transmission and 
receive mechanisms may be completely stateless. Any notion of state may be embedded in the message stream 
between sender and receiver. Thus, message transmission may be done asynchronously. In a preferred 
embodiment, no connection model is imposed. Thus, transports such as TCP are not required. Also, error 

0 conditions may be limited to non-delivery or security exceptions. 

Messaging layer 104 sits on top of a message capable networking layer 106. In a preferred embodiment, 
messaging layer 104 does not require that a particular networking protocol be used. TCP/IP and UDP/IP are 
examples of message capable protocols that may be used for message capable networking layer 106. However, 
other more specialized protocols such as the Wireless Application Protocol (WAP) may also be used. Other 

15 possible message protocols are IrDA and Bluetooth network drivers beneath the transport layer. Networking layer 
106 is not limited to a single reliable connection protocol, such as TCP/IP. Therefore, connection to a larger variety 
of devices is possible. 

In one embodiment, message capable network layer 106 may be implemented from the networking classes 
provided by the Java2 Micro Edition (J2ME) platform. The Java2 Micro Edition platform may be suitable for 
20 smaller footprint devices that do not have the resources for a full Java platform or in which it would not be efficient 
to run a full Java platform. Since J2ME already provides a message capable family of networking protocols (to 
support sockets), it follows that for the small footprint cost of adding messaging layer 104, distributing computing 
tacilities may be provided for small devices that already include J2ME. 

Message capable networking layer 106 may also be provided by the Java Development Kit's (JDK) 
25 javajiet networking classes. Alternatively, any message capable networking facilities may be used for message 
capable networking layer 106. In a preferred emboomient, a reliable transport is not required, thus embedded 
devices" supporting an unreliable data gram transport such as UDP/IP may still support the messaging layer. 

Thus, thin clients may participate in a distributed computing environment by simply adding a thin 
messaging layer 104 above a basic networking protocol stack. As shown in Figure 3, a basic system includes 
30 messaging layer 104 oh top of a networking layer 106. The networking layer may provide for reliable messages, 
eg. TCP, or unreliable messages, e.g. UDP. Hie Internet Protocol (IP) is shown in Figure 3 as an example of 
protocol that may be used in networking layer 106. However, the distributed computing environment does not 
require IP. Other protocols may be used in the distributed computing environment besides IP. A network driver 
such as for Ethernet, Token Ring, Bluetooth, etc. may also be part of the networking layer. Many small clients 
35 already provide a network driver and transport protocol such as UDP/IP. Thus, with the addition of the thin XML 
based messaging layer, the device may participate in the distributed computing environment 

Thus, the foundation for the distributed computing environment is a simple message passing layer 
implemented on top of reliable connection and/or unreliable data grams. The messaging technology is very different 
from communications technologies employed in other distribution confuting systems, such as Jim which employs 
40 ^ j ava remote method invocation (RMI). The message passing layer 104 supports an asynchronous, stateless style 
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of distributed programming, instead of the synchronous, state-full style predicated by RML Moreover, message 
passing layer 104 is based on a data representation language such as XML and thus copies data, but not code, from . 
source to destination, unlike RML By using a representation data language, such as XML, messaging layer 104 may 
interoperate with non-Java and non-Jini platforms in a seamless fashion because Java code is not assumed on the 
5 sending or receiving end of a message. Moreover, unlike RMI, messaging layer 104 does not require a reliable 
transport mechanism such as TCP/IP. 

The message passing layer may provide simple sendO and receiveO methods to send a message specified as 
an array or string of bytes, for example. The sendO method may return immediately, performing the data transfer 
asynchronously. For flow control purposes a callback method may be supplied which is invoked in the event that 
10 the sendO method throws an exception mdicating it cannot handle the sendO request The receiveO method may be 
synchronous and may return the next available message. 

The message passing layer may also provide methods for storing XML representations of objects, services 
and content in "spaces". A space is named and accessed on the network using an URI (Uniform Resource 
Identifier). The URI may be a URL (Uniform Resource Locator) or a simpler version of a URL. In some 
15 embodiments, the URL class may be too large. For such embodiments a simpler resource locator may be used that 
specifies the protocol for moving the messages between client and server, protocol dependent host ID, protocol 
dependent port ID, and a space name. 

An XML representation of an object may be added to a space using a writeO method provided by the 
messaging layer. In one embodiment, the object and the client-specified name may be supplied as parameters. In 
20 one embodiment, the write method may translate the object into its XML representation. A take() method may be 
provided to return the object and remove it from the space. A findQ method may be provided to return a specified 
object from its XML representation in a space. Hie findO method may also be used to return an array of matching 
objects in a space given a class. Each of these space methods is implemented using the message-passing layer. A 
lease mechanism may also be provided, as described in more detail below. 
25 A discovery service may be provided for clients as a general search facility that may be used by a client to 

locate a particular space. Rather than attempt to define a complicated search protocol which may not be feasible for 
a thin client to implement, the discovery service may offload the actual search to XML-based search fecilities, 
leaving the discovery service simply to provide interface functionality to the client The approach is illustrated in 
Figure 4. In one embodiment, the discovery service receives a string specifying something to locate, and it sends an 
30 XML message to a known discovery front-end (perhaps found in a default space), which then parses the string and 
makes a corresponding XML query to a search facility (which may be an internet search facility). The discovery 
front-end may parse what it obtains from the search facility and repackage it as an array of strings (each string may 
be a URI for each found space) which it may send in an XML message to the client It should be noted that the 
discovery service does not require that the messaging be atop a connection-oriented transport Thus, even very thin 
35 clients that do not have TCP could use such a discovery service. The discovery front-end makes it possible for the 
client to discover spaces without a browser or search facility on the client The client only needs a simple facility 
that sends a string that specifies keywords to the front-end, which interfaces with a search facility. 

A client may be any platform that can send a message using at least a subset of the API and messaging 
layers. In one embodiment the API layer may provide for both static (or raw) and formatted (or cooked) messages. 
40 A server may be any platform capable of receiving and fulfilling message requests. An explicit raw message send 



13 



WO 01/86394 



PCT/US01/15134 



may be provided that moves a series of bytes from a client to a server or to another client The message type may be 
specified as reliable (e.g. TCP) or unreliable (e.g. UDP). The smallest of devices may use raw unreliable message 
passing as their sole means of participation in the distributed computing environment The device may use these 
messages to announce its presence and its status. Such small devices may also receive raw messages to implement 
certain functions, such as turning a feature on or off 

Message-based services such as spaces may send and receive reliable formatted messages. A space 
message may be formatted with a well-defined header and with XML. In one embodiment, a formatted message 
send may occur when a client uses a space method to claim, write, or take objects from a space. The message 
contents may be dynamically formatted in XML and contain well-defined headers. Figure 5 illustrates client profiles 
supporting formatted and static messages. By using static messages, small devices may use a smaller profile of code 
to participate in the distributed computing environment For example, a small device could just send basic 
pre-defined messages. Depending on the client, the static pre-defined messages may consume a small amount of 
memory (e.g. <200 bytes). Static messages may also be an option even for larger devices. On the other hand, the 
dynamic XML messages may be useful when object values are not known at compile time. 

Turning now to Figure 6, a distributed computing model is illustrated that combines a messaging system 
with XML messages and XML object representation. The platform independence of XML may be leveraged so that 
the system may provide for a heterogeneous distributed computing environment Thus, client 110 may be 
implemented on almost any platform instead of a particular platform like Java. The messaging system may be 
implemented on any network capable messaging layer, such as Internet protocols (e.g. TCP/IP or UDP/IP). Thus, 
the computing environment may be distributed over the Internet In one embodiment, the messaging system may 
also use shared memory as a quick interprocess message passing mechanism when the client and/or space server 
and/or service are on the same computer system. The distributed computing model of Figure 6 may also be very 
scalable because almost any size client can be configured to send and/or receive XML messages. 

As shown in Figure 6, two kinds of software programs may run in the distributed computing model; 
services 1 12 and clients 110. Services 1 12 may advertise their capabilities to clients wishing to use the service. The 
services 1 12 may advertise then: capabilities in spaces 1 14. As illustrated in Figure 7, clients 1 10 and services 1 12 
may or may not reside within the same network device. For example, devices 120 and 124 each support one client, 
whereas service 1 12a and client 1 10b are implemented in the same device 122. Also, as illustrated in Figure 7, no 
particular platform is required for the devices to support the clients and services. For example, device 120 is Java 
based, whereas device 124 provides a native code runtime environment 

A device may be a networking transport addressable unit Example devices include, but by no means are 
limited to: PDAs, cellular/mobile phones, notebook computers, laptops, desktop computers, more powerful 
computer systems, even supercomputers. Both clients and services may be URI-addressable instances of software 
(or firmware) that run on devices. Using the distributed computing environment architecture, a client may run a 
service. A space is a service that manages a repository of XML documents. Even though it is redundant, the term, 
space service, may be used herein for readability. A software component may be both a client and service at 
different times. For example, when a service uses a space (e.g. to advertise itself), that service is a client of the 
space. 

Figure 8 illustrates the basic model of the distributed computing environment in one embodiment The 
distributed computing environment may connect clients 110 to services 112 throughout a network. The network 
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may be a wide area network such as the Internet The network may also be a combination of networks such as a 
local area network (LAN). connected to a wireless network over the Internet As shown in Figure 8, a service 1 12 
publishes an advertisement 132 for itself (represented in XML) in a space 1 14. The advertisement 132 specifies the 
service's XML schema and URI address. Then, a client 110 may look up the advertisement 13Z The client 110 
5 may use the advertisement 132 to instantiate a gate 130. The gate 130 allows the client 1 10 to run the service 1 12, 
by sending (and receiving) XML messages to (and from) the service 112. 

Some results of running a service may be returned to the client in an XML message. However, since other 
results may be too large for a small client to receive and consume at once, a service 112 may put those results or an 
XML representation of the results 134 in a space 114, as shown in Figure 9, and return them by reference (in an 
10 XML message) to the client 1 10, rather than by value. Examples of methods of returning a reference to results 
include, but are not limited to: returning in the message a URI referencing the results in a space, and: returning in the 
message an XML document including the URI of the results. Later, the client 110 may access the results, or pass 
them by reference to another service. The space in which results may be stored may be different from the space in 
which the service is advertised 
15 in one embodiment, the distributed computing environment uses XML for content definition, advertisement 

and description. New content for the distributed computing environment (messages and advertisements for 
example) are defined in XML: Existing content types (e.g. developed for other environments) may also be 
described using XML as a level of indirection (meta-data). XML provides a powerful means of representing data 
throughout a distributed system because, similar to the way that Java provides universal code, XML provides 
20 universal data. XML is language agnostic and is selMescribing. The XML content may be strongly typed and 
validated using schemas. Using a provided XML schema, the system may ensure that only valid XML content is 
passed in a message. XML content may also be translated, into other content types such as HTML and WML. 
Thus, clients that do not understand XML may still use the distributed computing environment services. 

In one embodiment, the distributed computing environment messages may define the protocol used to 
25 connect clients with services, and to address content in spaces and stores. The use of messages to define a protocol 
allows many different kinds of devices to participate in the protocol. Each device may be free to implement the 
protocol in a manner best suited to its abilities and role. For example, riot all devices are capable of supporting a 
Java runtime environment The distributed computing environment protocol definition does not require nor imply 
the use of Java on a . device. Nor does it preclude it 
30 A service's capabilities may be expressed in terms of the messages the service accepts. A service's message 

set may be defined using an XML schema. An XML message schema defines each message format using XML 
typed tags. The tag usage rules may also be defined in the schema. The message schema may be a component of an 
XML advertisement along with the service's message endpoint used to receive messages. The distributed computing 
environment may allow clients to use all or some subset of a service's capabilities. Security policies may be 
35 employed to enforce the set of capabilities given to a client For example, once a set of capabilities has been given 
to a client, the client may not change that set without proper authorization. This model of capability definition 
allows for services levels that range from a base set of capabilities to an extended set Extensions may be added to 
services by adding to the number of recognized messages. 

In one embodiment, all operations in the distributed computing environment are embodied as XML 
40 messages sent between clients and services. Storage (both transient and persistent) providers are examples of 
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services that enable clients and services to store, advertise, and address content Clients and services may find each 
other and broker content using a transient storage space. Services may place a content or service advertisement in a . 
space. The advertisement may describe the content type or the capabilities of the service. Clients may subsequently 
browse spaces looking for advertisements that match a desired set of capabilities. When a client finds a matching 
5 advertisement, a communication channel may be established which may enable bi-directional message passing to the 
service backing me advertisement In one embodiment, the communication channel is authenticated Results (which 
are just another content type) from service operations may be returned directly to the client in a response message, 
advertised and stored in a space, or advertised in a space, but stored persistently. Stored results may be addressed 
using a URI (e.g. returned in the response message) and may have an associated authentication credential. 

10 

Message Gates 

As discussed above, the distributed computing environment leverages off the use of a data description 
language, such as XML. XML may be used to describe a target entity (e.g. document, service, or client) to an extent 
such mat code may be generated to access that entity. The generated code for accessing the target entity may be 
15 referred to as a message gate. Thus, in one embodiment, the distributed computing environment differs from other 
distributed computing environments in that instead of passing the necessary code between objects necessary to 
access the other object, the environment provides access to XML descriptions of an object or target so that code 
may be generated based on the XML description to access the target The distributed computing environment may 
use an XML schema to ensure type safety as well as a programming mode! (e.g. supported messages) without having 
20 to agree upon language specific APIs, just XML schemas. 

Code generated from an XML schema may also incorporate the language, security, type safety, and 
execution environment characteristics of the local platform. The local platform may thus have control over the 
generated code to ensure that it is bug-free and produces only valid data according to the schema. The generated 
code may conform to the clienfs code execution environment (e.g. Java, C++, Smalltalk), as well as its management 
25 and security framework (W eb-server and/or operating system). 

Note that the distributed computing environment does not require that code generated from an XML 
schema be generated "on the fly" at runtime. Instead, some or all of the code may be pre-generated for categories 
(or classes) of services, and then linked-in during the platform build process. Pre-generation of code may be useful 
for some clients, such as embedded devices, where certain XML schemas are already known. In one embodiment, 
30 some or all of the code doesnt actually have to be generated at alL A private code-loading scheme (within the 
client) might be used in one embodiment to augment the generation process. In addition, the distributed computing 
environment may specify, in some embodiments, an interface to download code for additional features in accessing 
a service (see, e.g^ message conductors described below). Typically, such downloaded code may be small and the 
client may have the option to download the code or not 
35 The phrase "generated code" may refer to code that originates within the client under the control of the 

client code execution environment, or to code that is generated elsewhere (such as on the service system or on a 
space service system) and that may be downloaded to the client system after generation. Binding time, however, 
may be at runtime. At runtime, the generated code may be bound to a service address (URI), so mat a message may 
be sent to that service instance. 
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As discussed above, the interface to any service in the distributed computing environment may be specified 
by an XML schema, defining the set of messages that a client may send (and receive from) that service. As 
illustrated in Figure 10, the client 110 and service 112 may each construct a message gate 130 for communicating 
according to the specified XML schema; From the XML schema advertised for the service 1 12 (and possibly other 

5 information in the service advertisement), a message gate 130a or 130b may be constructed by the client 110a or 
1 10b respectively. A corresponding message gate 130c generated from the same XML schema may also exist on the 
service 112a. A gate 130 is a message endpoint that may send and/or receive type-safe XML messages, and that 
may verify the type correctness of XML messages when sending and/or receiving the messages. The message gate 
may also provide for authentication and/or other security mechanisms to ensure that the message endpoint is secure. 

10 In one embodiment, message gates are always secure. 

The distributed computing environment messaging layer described above may be coupled to or may be part 
of the gate. The messaging layer asynchronously delivers an ordered sequence of bytes, using a networking 
transport, from the sender to the receiver, mamtaining the notion on both the sender and receiver that this sequence 
of bytes is one atomic unit, the message. The distributed computing environment does not assume that the 

15 networking transport is IP-based. Instead, the messaging layer may sit atop whatever networking transport layer is 
supported by the device. 

Message gates may provide a mechanism to send and receive XML messages between clients and services. 
The XML messages may be "typed". For example, the messages may include tags to indicate if a message data field 
is, e.g., integer, floating point, text data, etc. A message gate may be constructed to verify the type correctness of 

20 messages sent or received A message gate also may authenticate (e.g. securely identify) the sender of a received 
message. An XML schema may be provided for a service that describes the set of messages accepted by the service 
and/or sent by the service. A message gate may verify the correctness of messages sent or received according to the 
XML schema for which the gate is constructed. 

A gate may be constructed as a single atomic unit of code and data that performs type verification. arid/or 

25 message correctness verification and/or sender identification for messages between a client and a service in the 
distributed computing environment In one embodiment, once the atomic unit of code and data for a message gate 
has been created, it cannot be altered as to its typing, message descriptors, and sender identification. In another 
embodiment, the gate may be modified as to the contents of the message schema after the gate is created, including 
deleting, nHdmg^ or modifying messages in the message schema. 

30 A message gate is the message endpoint for a client or service in the distributed computing environment A 

message gate may provide a secure message endpoint that sends and receives type-safe XML messages. Messages 
' gates may allow clients and services, to exchange XML messages in a secure and reliable fashion over any suitable 
message transport (e.g. HTTP). For a client, a message gate may represent the authority to use some or all of a 
service's capabilities. Each capability may be expressed in terms of a message that may be sent to a service. Each 

35 such message may be sent through a client message gate which may verify the correctness of the message. The 
message may be received by a service message gate which may authenticate the message and verify its correctness. 

A message gate may provide a secure communication endpoint mat type checks XML. messages. As 
further discussed below, a message gate may also provide a mechanism to restrict the message flow between clients 
and services. In one embodiment when a client desires to access a service, a client and service message gate pair is 

40 created, if not already existing. In one embodiment, the service message gate may be created when the service 
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receives a first message from the client message gate. In one embodiment, one or more service message gates may 
be created when the service is initialized, and may be used to pair with client message gates when created. The 
creation of a message gate may involve an authentication service that may negotiate the desired level of security and 
the set of messages that may be passed between client and service. In one embodiment, the authentication service 
5 may. accept a client ID token (also referred to as a client token), a service ID token (also referred to as a service 
token), and a data representation language message schema that describes the set of data representation language 
messages that may be sent to or received from the service. For example, messages may be described that may be 
sent from a client to a service to invoke the service or to invoke aspects of the service. Messages may also be 
described that are to be sent from the service, such as response messages and event notification messages. Refer to 
10 the Authentication and Security section below for a further discussion of how the authentication service may be used 
in the construction and use of message gates. 

A client message gate and a service message gate pair may allow messages to be sent between the client 
and the service. In one embodiment, message gates may be created that only send and/or receive a subset of the 
total set of messages as described in the message schema for a service. This limited access may be used within the 
15 distributed computing environment to implement a policy of least privilege whereby clients are only given access to 
specific individual message types, based on a security policy. Refer to the Authentication and Security section 
below for a further discussion of security checks for gate usage and gate creation. 

Client and service gates may perform the actual sending (and receiving) of the messages from the client to 
the service, using the protocol specified in the service advertisement (URI of service in the service advertisement). 
20 The client may run the service via this message passing. A message gate may provide a level of abstraction between 
a client and a service. A client may access a service object through a message gate instead of accessing the service 
object directly. Since the gate abstracts the service from the client, the service's code may not need to be loaded, 
and then started, until the client first uses the service. 

The client gate may also perform verification of the message against the XML schema, or verification of 
25 the message against the XML schema may be performed by the service gate, e.g. if the client indicates it has not yet 
been verified. In some embodiments, verification may not be practical for simple clients and may thus not be 
required at the client In some embodiments, verification may be performed by the service. The gates may also 
perform authentication enablement and/or security schemes. In one embodiment, if a client does not support the 
protocol specified in the service advertisement, then it may not be able to construct the right gate. To avoid this 
30 problem, service advertisements (used for gate construction) may include a list of possible URIs tor a service, so a 
variety of clients may be supported 

A basic message gate may implement an API to send and receive messages. The API moves data (e.g. 
XML messages) in and out of the gate, validating messages before sending and/ or upon receiving. In one 
embodiment, message gates may support a fixed minimum API to send and receive messages. This API may be 
35 extended to other features as discussed below. As illustrated in Figure 10b, a gate 130 may be generated according 
to an XML schema 132. The generated gate code verifies messages based upon the XML schema. The gate may 
verify correct message types and/or content through the message API. As illustrated in Figure 10b, through the 
message API a verified message may be sent to a service. The message may be received by a corresponding gate at 
the service. In response to the message, the service' may generate results 180. The service may return result data 
40 182 through its gate. The results data may be the results themselves or a reference to the results, such as a URI to 
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results stored in a space.. In various embodiments, the message API may support synchronous messages (request- 
response), asynchronous messages (response is disconnected from request), unicast messages (point to point), multi- 
cast messages (broadcast), and publish and subscribe (event messages), for example. Other type of messages may 
also be supported, such as remote method invocation messages. 

Each message sent by a gate may include an authentication credential so that the receiving gate may 
authenticate the message; Each message may also include a token which includes information allowing the 
receiving gate to verify that the message has not been compromised or altered. For example, the sender may 
compute a hash or checksum of the message which may be verified by the receiver. The sender may also encrypt 
this token and/or the entire message using the sender's private key and may include in the encrypted message the 
10 corresponding public key so that the receiver may verify that the token was not changed. See the section below on 
Authentication and Security. 

A pair of message gates may provide a mechanism for communicatmg requests from clients to services and 
response from services to clients. Two associated message gate endpoints may be used to create a secure atomic bi- 
directional message channel for request-response message passing. Thus, the distributed computing environment 
15 may employ a message transport in which a message gate exists on both the client and the service sides. The two 
gates may work together to provide a secure and reliable message channel. 

Turning now to Figure 1 la, an illustration is provided for one embodiment showing construction of a gate 
130a in a client 110 from a service advertisement or other service description 132. The client may have a gate 
factory 140 mat is trusted code on the client for generating gates based on XML service descriptions. The use of the 
20 gate factory 140 may ensure that the gate it generates is also trusted code, and that the code is correct with respect to 
the service advertisement As shown in Figure 1 lb, a gate 130c may also be constructed at a service 1 12. The client 
gate 130a and the service gate 130c provide message endpoints for communications between the client and service. 
In one embodiment, the pieces the gate factory needs to construct a gate 130 are the XML schema of the service 
(from the service advertisement) and the URI of the service (from the service advertisement). In another 
25 embodiment, an authentication credential may also be obtained and used in gate construction by running an 
authentication service specified in the service advertisement 

A gate factory may provide a trusted mechanism to create message gates. In some embodiments, in order 
to ensure that a message gate is a trusted message endpoint, the code used to create the gate must be trusted code. A 
gate factory 140 may be a trusted package of code that is used to create gates. In one embodiment, each client and 
30 service device platform that desires to send and receive messages in the distributed computing environment may 
have a gate factory. In some embodiments, gates may be pre^nstructed by a separate gate factory so that a device 
with pre-constructed gates may not need a full gate factory, or may include a partial gate factory for binding a 
service URI and/or an authentication credential to the pre-constructed gate at runtime (e.g. when messaging is 
desired). 

35 a gate factory for a device may generate gate code mat may incorporate the language, security, type safety, 

and/or execution environment characteristics of the local device platform. By constructing gates itself; a device has 
the ability to ensure that the generated gate code is bug-free, produces only valid data, and provides type-safety. An 
advantage of a device generating its own gate code as opposed to downloading code for accessing a service is that 
the client code management environment has the control The generated code may conform to the clients code 

40 execution environment (e.g. Java, C-H-, Smalltalk), as well as its management and security framework (Web-server 
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and/or operating system). Generated code is also trusted code, because die client's runtime environment was 
involved in its creation. Trusted security information therefore may also be added by the trusted generated code. 
Thus, a device may receive an XML message schema for a service and then construct a gate based on that schema to 
access the device. The XML schema may be viewed as defining the contract with the service and the generated gate 
5 code as providing a secure way to execute the contract Note that open devices, in which un-trusted (e.g. 
downloaded) code may be run, may be configured so that gates may be generated only by trusted code. Open 
devices may employ a process model in which gates are enclosed in a protected, isolated code container mat is not 
accessible to tools, such as debuggers, capable of discovering the gate's implementation, especially the gates 
authentication credentiaL 

10 A gate factory 140 may negotiate on behalf of a client with a service to create a gate to send messages to 

the service. Similarly, a gate may be constructed at the service to receive messages from the client gate and send 
messages to the client gate. Together, the client and service gates may form a secure bi-directi onal communication 
channeL 

A gate factory may provide a level of abstraction in gate creation. For example, when a client desires to 
15 use a service, instead of the client directly creating a gate to access the service, the gate may be created by a gate 
factory as part of instantiating the service. 

The gate factory may create or may include its own trusted message gate that is used to communicate with 
an authentication service (e.g. specified by a service advertisement) to receive an authentication credential for the 
gate being constructed. For services that do not restrict access, a gate may be constructed without an authentication 
20 credential. The gates for such services may not need to send an authentication credential with each message since 
the service does not restrict access. The authentication service is an example of a service that does not restrict 
access, in one embodiment Thus, a gate factory may be configured to optimize gate construction by checking 
whether a service restricts access. If the service does not restrict access, then the gate factory may avoid running an 
authentication service as part of gate construction and may avoid included provisions for an authentication 
25 credential as part of the constructed gate. The gate factory may also receive or download an XML message schema 
(e.g. specified by a service advertisement) to create a gate matching that schema. The gate factory may also 
receive or download a TJRI for the service and/or for a service message gate for use in creating the client message 
gate to communicate with the URL 

In addition, another gate construction optrmization may be employed for certain clients that do not desire to 
30 perform checking of messages against a service's XML schema. The client may be too thin to perform the checking 
or may rely on the service gate to perform the checking or may simply choose not to perform the checking (e.g. to 
reduce gate memory footprint). The gate factory may be configured to receive an indication of whether or not a gate 
should be constructed to verify messages against the provided XML schema. In some embodiments, certain clients 
may have a gate factory that does not provide for message verification against a schema for its constructed gates. In 
35 some embodiments, gates may be pre-constructed not to verify messages. In some embodiments, a gate may be 
constructed to verify outgoing messages only, or verify received messages only. Thus, in some embodiments, a 
client may avoid or may chose to avoid building some or all of the gate code that checks the messages against the 
XML schema. 

In some embodiments, devices may maintain a cache of gates to avoid constructing them each time the 
40 same service is run. For example, when a new gate is constructed by a gate factory, the gate may be maintained in a 
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gate cache. When the gate is no longer being used, it is kept in the gate cache instead of being deleted. If the gate 
cache becomes full, one or more gates may be removed from the gate cache according to a cache replacement 
algorithm, such as least recently used When the gate factory is called to construct a gate, it first checks the gate 
cache to see if a matching gate already exists so that construction of a new gate may be avoided. 
5 The building of a gate may be made lightweight by appropriate reuse of pieces used to construct other 

gates. Certain portions of each gate may be the same, and thus may be reused from gate to gate, such as parts of the 
message verification code. Also, for some devices, common gate code may be built into the system software for the 
device and shared by all gates on that device. Thus, the gate factory may avoid rebuilding this common code for 
each gate. Instead, the gate factory may simply bind the gate to this system software portion. For example, a system 
10 software portion may be provided to handle the message layer over whatever transports are provided on the device. 

Space services in particular may be good candidates for many of the gate construction optimizations 
described above since a service gate constructed for a space service may perform many of the same functions as 
other service gates for that space service. Refer to the Spaces section below for more information on space services. 
In some instances, a more efficient form of method invocation may exist For example, if the target service 
15 runs in the same Java Virtual Machine as the client application, a more efficient form of method invocation may be 
to create a Java dynamic proxy class for the service. In such a case, a java.langjeflectMethod invocation may be 
faster than sending a message. A gate binding time procedure may check for such an optimization and use it instead 
of r unnin g the gate factory to create a gate or bind an existing gate. 

In one embodiment, such as for special-purpose clients or small embedded devices, the generation of gate 
20 code at runtime may not be desirable due to memory consumption and code generation time. Thus, instead of 
having a gate factory that generates gates at runtime, in some embodiments gates may be pre-generated and built 
into the device. For example, message gates may be generated during the build of embedded software as a means of 
including a built-in secure message endpoint that does not have to be constructed at runtime. Thus, a client with 
built-in gates may not need a full gate factory, or may require only a partial gate factory for performing certain 
25 runtime binding to a built-in gate, such as for the URI and/or authentication credential. 

A generation tool may be provided for the pre-construction of gates. The generation tool may include an 
XML parser, a code generator and a code compiler. In one embodiment, the code generator may be a Java source 
code generator and the code compiler may be a Java code compiler. During the build of the software for which 
built-in message gates is desired, the generation tool is run with input from all the relevant XML schemas for which 
30 gates are desired. 

As an example, if it is desired for a device to have a built-in message gate that can send and receive 
messages from a digital camera, the build of the device software may include running the gate generation tool with 
the camera's XML message schema as input The XML schema may be parsed by the XML parser that may convert 
the XML schema into an internal form suitable for quick access during a message verification process. . The tool's 

35 code generator may provide source code for a gate conesrxmding to the camera's schema. In some embodiments, 
the generation tool may also compile the source code and the gate code may be linked into the software package for 
the device. At runtime, the camera service may be discovered in the distributed computing environment The 
message URI for the camera service may be bound to the built-in gate for the camera within the device. The binding 
of the URI to the pre-constructed gate may be performed by a gate constructor within the device. This gate 

40 constructor may be a much smaller, simpler gate factory. When the camera service is ins t a ntiat ed, the URI for the 
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camera service is passed to the gate constructor as an XML message. Hie gate constructor may then bind the URI to 
the pre-constructed gate. 

Tnus, a gate may be partially or fully generated at runtime, or a gate may be pre-generated before runtime 
with a binding process (e.g. for a URI or credential) performed at runtime. In one embodiment, a gate generation 
5 tool such as the gate factory or the generation tool for pre-constructed gates may be a Java-based tool to provide 
some level of platform independence. Alternatively, gate generation tools may be provided in any language, such as 
the native code for a particular device in the distributed computing environment 

Note that the distributed computing environment does not preclude a device from downloading part or all 
of a gate's code. For example, in some embodiments, a service may provide gate code that may be downloaded by a 
10 client wishing to access that service. However, downloaded code may present size, security and/or safety risks. 

A more detailed illustration of possible gate components for one embodiment is shown in Figure 12. A 
gate may include its address (or name) 150, a destination gate address 152, a valid XML schema (or internal form 
thereof) 154, and a transport URI 153. In other embodiments, a gate may also include an authentication credential 
156. Some gates may also include a lease 158 and/or a message conductor 160 to verify message ordering. 
15 A gate's name 150 may be a unique ED that will (for the life of the gate) refer only to it A gate may be 

addressed using its gate name 150. In one embodiment, gate names may be generated as a combination of a string 
from an XML schema (e.g. from a service advertisement) and a random number, such as a 128-bit random number. 
The name 150 may allow clients and services to migrate about the network and still work together. In a preferred 
embodiment, the gate address is independent of the physical message transport address and/or socket layer. Thus, a 
20 gate name may provide a virtual message endpoint address mat may be bound and un-bound to a message transport 
address. In one embodiment, a gate's name may be a Universal Unique Identifier (UUID) mat may, for the life of 
the gate, refer only to it 

A gate name may persist as long as the gate persists so mat different applications and clients executing 
within the same device may locate and use a particular gate repeatedly. For example, a gate may be created for a 

25 first client process executing within a device to access a service. After the first client process has completed its 
activity with the service, it may release the gate. Releasing the gate may involve un-binding the gate from the first 
client process's message transport address (e.g. IP and/or Port address). The gate may be stored in a gate cache or 
repository. A second client process executing within the same device that desires to run the same service may locate 
me gate by its name and use it to access me service. To use the gate, the second client process may bind the gateto 

30 its message transport address, so that the message endpoint for the second client process is a combination of the gate 
name and the second client process's transport address. In another example, a client may receive a dynamic IP 
address (e.g. a mobile client). When the clienf s transport address changes, a gate name (or gate names) may be re- 
: bound to the client's new transport address so that me chent may stm access a services) tha^ 

without having to relocate die service and recreate the gate. A gate name may also be useful for process migration. 

35 A process and any associated gates may be checkpointed or saved at one node in the distributed computing 
environment and moved to another node. Hie process may be restarted at the new node and the associated gates 
may be bound to die transport address for the new node so that the process will still have access to the external 
services to which it had access before being migrated. A gate may track the current location of another gate to 
which it is paired Thus a service or client may be migrated and still be accessible. For example, replicated or Ioad- 

40 balanced service implementations may be abstracted from clients of the service by the gate. 
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Thus, a gate name 150 provides a flexible mechanism by which to address a message endpoint in the 
distributed computing environment A gate name may be used to locate and/or address a gate over a wide range of 
networks, from a local network to the Internet Gate names may be independent of message transport so that a 
message endpoint (gate) may be moved from transport to transport by unbinding and rebinding to different 
5 . underlying transport addresses (e f g. IP/Port address pairs). 

In one embodiment, a gate may also be separated from a service so that the same gate may be used to send 
requests to different services over time. This may involve un-binding the gate's destination gate address 152 and 
binding a new destination gate address to the gate. 

A gate may be implemented as a layer above a device's transport layer (e.g. networking sockets). Each 
10 gate may include a transport reference 153. The gate name 150 may be bound to the transport reference 153 as 
described above. Multiple gates may share the same message transport For example, multiple gates may have 
transport references 153 to the same TCP/IP socket By sharing the same message transport, the size and 
complexity of each gate may be reduced A device in the distributed computing environment may have a large 
number of gates that need to send and receive messages. The message handling complexity for multiple gates may 
15 be reduced by sharing a common message transport The transport reference 153 may be a transport URI (e.g. 
URL) or socket reference and may provide a mechanism for naming an underlying transport and sharing the 
transport with other gates. Multiple local gates may include a reference 153 to the same transport, however, each 
local gate may behave independently of the other local gates sending and receiving messages to and from its paired 
remote gate. 

20 The schema 154 may be downloaded from a space into the gate by the gate factory. The schema may be 

compiled into an internal form suitable for quick access during a message verification process. In one embodiment, 
the schema may specify two groups of messages: client service messages and provider service messages. The client 
service messages group includes the description of all messages that the client may send (that the provider supports), 
and the provider service messages group includes the description of all messages that the provider may send (that 

25 the client receives). In one embodiment, either the client or provider may send a particular request to the space 
service to obtain a response message with either the entire client service messages, the entire provider service 
messages, the entire client and provider service messages, or a specific message of either the client service messages 
or the provider service messages. In addition, once a gate has been constructed, a client may query as to the 
capabilities of the service without the gate actually sending a message, but instead by inspecting the gate's set of 

30 messages. 

As described above, a message gate may verify the sender of the message using an authentication 
credential, message content for type safety and according to an XML schema. However, it may also be desirable to 
verify that messages are sent between a client and a service in the correct order. It may be desirable to be able to 
provision applications (services) for clients to run without any pre-existing specific functionality related to the 
35 application on the client (e.g. no GUI for the application on the client). For example, a Web browser may be used 
on a client as the GUI for a service instead of requiring an application-specific GUI Of the possible messages in the 
XML schema, the client may need to know what message next to send to the service. It may be desirable for the 
client to be able to determine which message to send next without requiring the client to have specific knowledge of 
the service. In one embodiment, the service may continually send response messages indicating the next input it 
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needs. The service would then accept only the corresponding messages from the client with the requested input 
specified. Other ad hoc scheme for message ordering may also be employed. 

In another embodiment, a message conductor 160 may be employed in the gate or associated with the gate 
to verify the correct sequence of messages, as opposed to verifying each message's syntax (which may already be 
5 performed in the gate according to the schema). Message conductor 160 may provide a more general approach for 
application provisioning. The message conductor 160 may be specified in a service's advertisement The message 
conductor indication in a schema may allow code to be generated on or downloaded to the client during gate 
construction, which may provide the choreography needed to decide which message to send next to the service, A 
message conductor may be implemented as a Java apphcation, a Java Script, WML script, or in other programing 
10 or scripting languages. 

In one embodiment, the message conductor may accept as input an XML document (e.g. from a service 
advertisement) mat presents the valid order or choreography for messages that may be sent between a client and the 
service. This XML document may also specify user interface information and other rules. The conductor may parse 
this XML document into an internal form and enforce message ordering (and/or other rules) according to the 
15 enclosed ordering information^ The conductor may prevent messages from being sent out of order. Or, if a message 
is sent out of order, an exception may be raised withm me sending device. If a message is received out of order, the 
conductor may send an automatic response message back declaring the ordering error. The sender may men resend 
messages in the correct order. Note that in some embodiments, part or all of a conductor may be shared by several 
gates. Thus, a conductor may be linked to multiple gates. 
20 In one embodiment of a distributed computing environment, front ends for services (service interfaces) may 

be built in to clients. In one embodiment, the service interlace may be a preconstructed user interlace provided to 
the client by the service. In one embodiment, the service interface may be provided to the client in the service 
advertisement The service interlace may interact on the client with the user of the service to obtain input for 
running the service, and then may display results of running the service on the client A "user" may be a human, 
25 embedded system, another client or service, etc. In one embodiment, a client device may not be able to provision 
arbitrary services, as the client device may only be able to run services for which it has a front end built in. In one 
embodiment, a service interface for a service may be implemented in a Web browser on the client 

In one embodiment, a message conductor and/or service interlace may be external to the gate and thus 
abstracted from the gate and client The abstracted message conductor may provide provisiomng of arbitrary 
30 services to any client device. In one embodiment, the message conductor may be written in code that may run on 
substantially any platform. In one embodiment, the message conductor may be written in the Java language. In one 
embodiment, the message conductor may not require the arbitrary downloading of objects, for example, Java 
objects, returned to the client device. For example, very large objects may be returned, and the message conductor 
may choose to not download these very large objects. In one embodiment, the message conductor may send XML 
35 messages to services from the client device on behalf of the client The message conductor may interact with the 
user of the service to receive input and display results. 

In one embodiment, a service interface may be provided mat interacts with the client (e.g. thru a user 
interlace) to obtain all information to run the service, and men may display either results of ninning the service or 
information regarding the location of results, as appropriate. The service interlace may be either part of a message 
40 conductor 160 or may be in addition to and work with message conductor 160. The service interlace may either be: 
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1 . Built in to the client device and thus ran on the client 

2. Downloaded to the client device from the space server. 

3. Run on the space server. 

4. Run on the service provider. 

In one embodiment, to a client, the distributed computing environment space server must support #1 always, 
indicate if #2 is supported (by advertisement in space), indicate if at least one of #3 and $4 is supported. Note mat 
whether or not it supports #4 depends upon whether or not the service provider supports #4. In one embodiment, to 
a service provider, the distributed computing environment space server must support #4 always and indicate if it 
supports #3. 

Regardless of where the service interface runs, once a service is activated, the service interlace may interact 
with the client, displaying (remotely) requests for input on the client's display, and then displaying (remotely) results 
of running the service. Such interaction with the client is implemented in terms of XML messages. 

The service interlace and/or message conductor may meet the needs of a client user that may have 
discovered a service, but does not want to read a typically large, dry computer manual to figure out how to use the 
service. As the service interface and/or message conductor interacts with the user to request all input mat the service 
needs, they may even provide short descriptions of the input requested if the user requests it Once the service 
interface has obtained the necessary information from the client, it may send XML messages to the service provider 
that runs the service. The ordering of the messages may be verified by the message conductor 160 in the gate. 

In a preferred embodiment, all messages flow through a gate. A gate may be configured to provide a flow 
control mechanism For example, a service may need to handle a large amount of incoming and outgoing messages. 
Flow control may allow a service to keep up with high traffic volume. Gates may be configured to monitor 
messages for flow control tags. When a gate receives a message, it may examine mat message for a flow control tag. 
The flow control tags may be XML tags. A message may include either an OFF tag or an ON tag, for example. If a 
received message includes an OFF tag, the receiving gate will stop sending messages to its paired destination gate. 
If the gate receives a message including an ON tag, it may resume sending messages. 

Thus, a service-side gate may monitor the use of its resources and trigger flow control if use of its resources 
exceeds a threshold. For example, a service may reduce its load by sending messages including OFF tags to one or 
more client gates. The client gates receiving the messages with OFF tags will stop sending messages to the service. 
Pending messages in the clients may be buffered or may be handled by internal flow control mechariisms. Once the 
service is able to handle more requests, it may send messages to one or more clients with ON tags so that the clients 
may resume sending messages. In other embodiments, other flow control tags may be supported in addition to or 
instead of ON and OFF. Other flow control tags may indicate to reduce message flow or that message flow may be 
increased. 

Message gates may be configured to perform resource morntoring. For example, since all messages may 
flow through a gate, the gate may be configured to manage and/or track a client's use of a service (and possibly its 
associated resources such as memory or threads). A gate may be configured to track the activity of a software 
program, such as a client, by monitoring how much a resource, such as a service, is used or which and bow many, 
service resources are used. In one embcKiiment, a gate may generate or may facilitate generation of a client activity 
log. Each message and its destination or sender may be logged. 
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A gate may also be configured to perform resource monitoring for flow control from the local (sending) 
side of a gate pair. If the client exceeds an allocated bandwidth of service (or resource) usage, the gate may. 
automatically throttle back the flow of messages, for example. Thus, a client-side message gate may automatically 
trigger different flow control modes by monitoring the flow of outgoing messages. If the outgoing message flow 
exceeds a threshold, the gate may reduce or shut off its flow of outgoing messages. The threshold may be specified 
in a service's XML schema or advertisement In some embodiments, the threshold may be specified only for 
messages using certain service resources or for all messages. 

The gate may also be configured to determine when message flow may be increased or resumed. In one 
embodiment, the gate may maintain a count of outgoing messages that have been sent without the matching reply 
(response) received. When matching responses are received by the client-side gate, the count of outstanding request 
messages may be decremented. When the counts decrements below a specified outstanding request message 
threshold, the gate may increase or resume sending new request messages! 

A gate may be configured to support message-based accounting and/or billing. A billing system may be 
implemented based upon the number and/or kind of messages sent and/or received by a message gate. Since all 
messages to and from a client may pass through a gate, the gate may be configured to facilitate charging a client for 
service usage, for example on a per message basis or "pay as you go". Thus, a billing system may be implemented 
within the distributed computing environment in which a user could be charged, for example, each time a message is 
sent and/or received by software running on behalf of the user. 

In one embodiment, a message gate may receive billing information from an XML schema, e.g. for a 
service. The billing information may denote a billing policy and a charge-back URL The charge-back URI may be 
used by the message gate to charge time or usage on behalf of a user. A message gate may make a charge-back by 
sending a charge message to the charge-back URI specified in the XML schema. Gates so configured may be 
referred to as bill gates. Hie billing policy may indicate charge amounts per message or per cumulative message 
totals, etc. The billing policy may indicate how much and/or how often (e.g. after every x number of messages sent 
and/or received) to charge the user. The policy may indicate that only certain types of messages trigger charges, 
such a messages requesting a specified service resource. The billing policy may also indicate different billing 
models for different clients or classes of clients. For example, a billing policy may be configured (e.g. in a service's 
XML schema) so that some clients may pay a one-time charge when they create a gate to access the service. The 
policy may indicate clients that are to pay as they go (e.g. per message), or may indicate clients that are not to be 
charged at all 

In some embodiments, a client may be too thin to support a full gate, or a client may not include software to 
directry participate in the distributed computing environment In such embodiments, a server (such as the space 
server in which the service is advertised or another server) may be a full or partial proxy gate for the client The 
server may instantiate a service agent (which may include a gate) fox each service to be used by the client Hie 
service agent may verify permission to send messages; send messages to the provider, possibly queuing mem until 
the provider can accept the next one; send messages to the client, possibly queuing them until the client can accept 
the next one; and manage the storing of results in a result or activation space. See also the Bridging section herein. 

For example, as illustrated in Figure 13, a client may be a conventional browser 400 that does not support 
gates to participate directry in the messaging scheme described above. The browser 400 may be aided by a proxy 
soviet (agent) 402. The browser user may use a search engine to find a Web page that fronts (displays the contents 
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of) a space advertising services within the distributed computing environment The user is able to point and click on 
the space Web page and, with the help of the servlet, to access services. The Web pages may include scripts, for 
example, Java or WML scripts, which may be used in connecting the browser to the proxy servlet Scripts may also 
be used to send messages to the proxy servlet The servlet agent may translate Web page actions into messages on 

5 behalf of the browser client These actions may include navigating a space, starting services, and returning results. 
Result page URls (referencing pages containing XML) may be returned directly (or translated into HTML or WAP 
if needed) to the browser, for display to the user. Thus, the browser-based client does not need to know how to start 
services, nor which messages to send during the service usage session. For example, a user of a WAP browser (e.g. 
on a cell phone) may connect to a space page, browse its contents (services), and then start a service, all by pointing 

10 and clicking. The agent 402 provides the client interface between the conventional client and the distributed 
computing environment 

The distributed computing environment may include several different types of message gates for 
communicating between clients and services that support different features. For example, as discussed above, some 
gates may support flow control or billing. Another type of message gate may support a form of remote method 

15 invocation. This type of gate may be referred to as a method gate. 

A gate is a secure message endpoint that sends and receives type-safe messages, e.g. XML messages. The 
remote method invocation (RMI) style gate may be referred to as a method gate, lie direct data-centric gate may be 
referred to as a message gate. A method gate may be implemented as a "layer" on top of a message gate. The exact 
implementation may be defined in the platform binding. 

20 Figure 14 illustrates the use of a method gate to provide a remote method invocation interface to a service. 

Method gates provide a method interface between clients and services. A method gate may be bi-directional, 
allowing remote method invocations from client to service and from service to client A method gate 172 may be 
generated from XML schema infbrrnation 170 (e.g: from a service advertisement in a space). The XML schema 
information 170 includes XML defining a method interface^). From this information, code may be generated as 

25 part of the gate for interfacing to one or more methods. Each method invocation (e.g. from a client application 1 76) 
in the generated code may cause a message to be sent to the service containing the marshaled method parameters. 
The message syntax and parameters to be included may be specified in the XML schema. Thus, the method gate 
172 provides an XML message interface to remotely invoke a service method. The method gate may be generated 
on the client or proxied on a server, such as the space server where the service method was advertised or a special 

30 gateway server. 

A service may have a corresponding method gate that implements or is linked to a set of object methods 
that correspond to the set of method messages defined in the service's XML schema, There may be a one to one 
correspondence between the object methods implemented by or linked to the service's method gate and the method 
messages defined by the service's XML schema. Once a service's wnesponding method receives a message from a 
35 client to invoice one of the service's methods, the service's method gate may unmarshal or unpack the parameters of 
the message invocation and then invoke the method indicated by me received message and pass the unmarshalled 
parameters. 

The method gate may provide a synchronous request-response message interface in which clients remotely 
call methods causing services to return results. The underlying message p as s in g mechanics may.be completely 
40 hidden from the client This form of remote method invocation may deal with method results as follows. Instead of 



27 



WO 01/86394 



PCTAJS01/15134 



downloading result objects (and associated classes) into the client, only a result reference or references are returned 
in XML messages, in one embodiment An object reference 178 may be a generated code proxy (e.g. results gate) 
representing the real object result 180 (still stored out on the net, for example). In other embodiments, the client 
may choose to receive the actual result object In addition, once a client has received a result object reference, the 
client may use this reference to receive or manipulate the actual result object In one embodiment, the result 
reference includes one or more URIs to the real result 

The real result object(s) may be stored in a service results space (which may be created dynamically by a 
servlet, for example). This temporary results space may act as a query results cache. The results cache (space) may 
be patrolled by server software (garbage collector) that cleans up old result areas. Results returned from each 
method invocation may be advertised in the results space. A result itself may be or may include a method mat could 
then be remotely instantiated by a client, thus generating its own method gate. Therefore, the distributed computing 
environment may support recursive remote method invocation. 

As mentioned above, when a client uses a method gate to remotely invoke a service method, a reference to 
the method results may be returned from the service method gate instead of the actual results. From this reference, a 
results gate may be generated to access the actual result Thus, the client or client method gate may receive a result 
URI and perhaps a result XML schema and/or authentication credential for constructing a gate to access the remote 
method results. 

In one embodiment, a service gate may create a "child gate" for the results. This child results gate may 
share the same authentication credential as its parent gate. In some embodiments, results may have a different set of 
access rights and thus may not share the same authentication credential as its parent For example, a payroll service 
may allow a different set of users to initiate than to read the payroll service's results (paychecks). 

A service method gate may return a child results gate to the client gate as the result of the method. The 
client may then use the results gate to access the actual results. In one embodiment, the software program (client) 
receiving the results gate cannot distinguish between the results gate and the result itself in which case the results 
gate may be an object proxy for the actual result object The results gate may also be a method gate that supports 
remote method invocation to result objects. In this manner, a chain of parent and child method/results gates may be 
created. 

In one embodiment, the method gates and remote methods may be in Java: In this embodiment, method 
results are correctly typed according to the Java typing system. When a Java method is remotely invoked as 
described above, the results gate may be cast into the Java type that matches the result type. In this embodiment, 
method gates may be used in the distributed computing environment to allow remote Java objects to behave as local 
Java objects. The method invocation and results may appear the same to the client Java software program whether 
me real object is local or remote. 

See the Spaces section below for a further discussion on the use of spaces for results. 

Message gates may also support publish and subscribe message passing for events. Message gates with 
event support may be referred to as event gates. A service's XML schema may indicate a set of one or more events 
that may be published by the service. An event gate may be constructed from the XML schema. The event gate 
may be configured to recognize some or all of the set of events published by a service, subscribe to those events, and 
- distribute each event as the event is produced by the service. 
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The set of events for a service may be described in the service's XML message schema. For each event 
message in the XML schema, the event gate may subscribe itself as a consumer of that event In one embodiment, 
an event gate subscribes to all events indicated by the XML schema. Each event message may be named using an 
XML tag. The event gate may subscribe by sending a subscription message including the XML tag for the event to 
5 be subscribed to. 

When a corresponding event occurs with the service, the service may send an event message to subscribers 
indicating the occurrence of the event The event message may contain an XML event document and may be sent to 
each subscribed gate. When a subscribed gate receives the event message, the XML event document is removed 
from the message and the process of distribution begins. Event distribution is the process of handing out the event 

10 document within the client platform. Each event consumer within the client platform may subscribe with the event 
gate for each type of event On Java platforms, the typing system is Java (converted from the XML event type). 

The event consumer may supply an event handler callback method to the event gate. The event gate may 
store a list of these subscriptions. As each event message arrives at the gate (from the service producing the event), 
the gate traverses the list of client consumers and calls each handler method, passing the XML event document as a 

15 parameter. In one embodiment, the XML event document is the only parameter passed to the handler callback 
method. 

In one embodiment the event gate automatically subscribes itself for events on behalf of the local consumer 
clients. As clients register interest with the gate, the gate registers interest with the event producer service. A client 
may also un-subscribe interest, which causes the gate to un-register itself with the service producing the event 
20 An event gate may type check the event document using the XML schema just like a regular message gate 

does in the standard request-response message passing style described above. An event gate may also include an 
authentication credential in messages it sends and verify the authentication credentials of received event messages. 

Note that any combination of the gate functionality described above may be supported in a single gate. 
Each type has been described separately only for clarity. For example, a gate may be a message gate, a method gate 
25 and an event gate, and may support flow control and resource monitoring 

Service Discovery Mechanisms 

In one embodiment, the distributed computing environment may include a service discovery mechanism 
that provides methods for clients to find services and to negotiate the rights to use some or all of a service's 
30 capabilities. Note mat a space is an example of a service. The service discovery mechanism may be secure, and 
may track and match outgoing client requests with incoming service responses. 

A service discovery mechanism may provide various capabilities including, but not limited to: 

• Finding a service using flexible search criteria. 

• Requesting an authorization mechanism, for example, an authentication credential, that may convey to the 
35 client the right to use the entire set or a subset of the entire set of a service's capabilities. 

• Requesting a credential, document, or other object that may convey to the client the service's interface. In 
one embodiment, the service's interface may include interlaces to a requested set of the service's 
capabilities. 
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• The tracking of discovery responses to the original requests. In one embodiment, each client request may 
include a collection of data that may also be returned in matching responses, thus allowing the requests and 
responses to be correlated. 

In one embodiment of the distributed computing environment, a sendee discovery mechanism may provide 
5 a flexible search criteria based upon an extensible grammar. In one embodiment, a service name, service type, and 
other elements, if any, being searched for may be matched with elements in an XML document In one embodiment, 
the XML document is the service advertisement for the service. XML may provide a flexible, extensible grammar 
for searching. XML also may provide type safety for matching elements. In one embodiment, the service names 
and service types may be type checked with the element types in the XML service advertisement 
10 In one embodiment, a distributed computing environment may include a mechanism for clients to negotiate 

service access rights. In one embodiment, the mechanism may be used to negotiate for a subset of a service's full 
capabilities. The result of the negotiation may be an authorization such as an authentication credential that conveys 
to the client the right to use the requested subset of the service's capabilities. 

In one embodiment, the service discovery mechanism may allow a client to request a security capability 
15 credential from a service. In one embodiment, the client may present to the service a set of desired capabilities in 
the form of a protected (secure) advertisement The service may men respond with a capability credential that may 
convey to the client the rights to use the requested capabilities described in the protected advertisement 

In one embodiment, the distributed computing environment may include a mechanism for a client to 
negotiate service access rights and to then obtain a security credential or document that may be used to present the 
20 service's access interlace to the set or subset of the service's capabilities that were requested by the client 

In one embodiment, a client that receives a capability credential from a service may generate a custom 
service access interface document mat may be referred to as a "complete advertisement'' In one embodiment, the 
complete advertisement may be an XML document The generated advertisement may provide access to the service 
capabilities as granted to the client by the received capability credential In one embodiment, an interface may be 
25 provided by the advertisement only to the service capabiUties to wMch me chent has been granted acc^ 

capability credential. In one embodiment, the client may be granted access to only required capabilities and to 
which the client has access privileges. 

In one embodiment, the distributed computing environment may provide a mechanism by which a client 
may negotiate capabilities with services. In one embodiment, the client may negotiate its capabilities to the service. 
30 The service may then customize results based on the parameters negotiated with the client For example, a client 
that is capable of one bit display at a resolution of 160x200 may negotiate these parameters to the service, thus 
allowing the service to customize results for the client 

The following is included as an example of an XML capabilities message and is not intended to be limiting 
in any way: 

35 

<type name="Capabilities"> 

<element name^display" type^string n /> 
<element name= n memoiy" type^"string , 7> 
<element name= n rnime w type="string7> 
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The distributed computing environment may include a mechanism that may allow clients to negotiate how a 
service is to return results of a service invocation. In one embodiment, during a capability credential request, a 
means by which to choose one of the results return methods may be conveyed to the service. The service may then 
generate a custom service advertisement that may convey to the client the results mechanism to be used, as well as 
the service interface/ 

Thus, the service discovery protocol may allow clients to search for services (both space services and 
specific services or types of services). Service providers (or a listener agent) may respond to search requests by 
publishing or providing corresponding advertisements or URIs to corresponding advertisements. When a service 
provider responds to a discovery search request (either directly or through a listener agent), the provider may choose 
to publish a protected or an un-protected (complete) advertisement A protected advertisement may include the set 
of information necessary to obtain a complete advertisement Publishing a protected advertisement forces the client 
to obtain a valid credential from an authentication service before receiving the complete un-protected advertisement 
from the service provider. A complete un-protected advertisement is needed to create a gate, and therefore to use 
the service. Forcing clients to obtain a valid credential before receiving an advertisement may provide an additional 
level of security for the service provider. The security credential that must be obtained to receive the complete 
advertisement may be the same security credential that is used to construct a gate to communicate with the service 
where the gate embeds the security credential in each message to the service. 

Whether or not a service provider publishes a protected or complete advertisement may be based upon the 
service provider's desired level of security. Complete advertisements contain the service's message endpoint URL 
Concealing this address may be a desirable security feature in many kinds of networks and deployment 
environments. However, simple proximity networks like IRDA, validate clients by requiring the client be in close 
proximity to the service provider. Concealing the IRDA message address from a close proximity client may just be 
redundant or too burdensome. In either case, the discovery search response choice may be left to the service 
provider. In a preferred embodiment, clients (or client gate factories) are configured to process either search 
response. 

Turning now to Fig. 41, a flow chart illustrating service discovery is illustrated according to one 
embodiment A client locates one or more advertisements for service(s) the client may desire to use, as indicated at 
2072. In one embodiment, the client may locate services by sending a search message. Turning now to Fig. 42, a 
flow chart illustrating a more detailed example of locating service advertisements is illustrated for one embodiment 
The client may send (e.g. broadcast, multicast, etc.) a search message indicating service name and/or service type 
search criteria, as indicated at 2071. 

The following is an example for one embodiment of a search message that may be sent on one or more 
available message transports when a client wishes to search for services: 

<Discover>. 
<Search> 

<SearehType> Type<SearchType> 

<SearchName> Name<ySearchName> 
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<SearchComment> Comment</SeardiComment> 
</Search> 
</Discover> 

5 The search message is formatted according to a data representational language. The search and discovery 

tags may be required. The search tags may contain an optional set of search criteria, useful for narrowing the 
possible results returned from service providers. Hie optional search criteria components may include a name (e.g. 
String). The name is compared with a service's name. If the search name matches the beaming or all of the 
service's name, a match may be declared for that service. In one embodiment, if the name isn't provided, aU service 
10 names are considered a match. 

Hie optional search criteria coirmonents may also include a type (e.g. String). Hie type is compared with 
the service type, e.g. in the service description's "Title" field. If the search type matches the begmning or all of the 
service's type, a match may be declared In one embodiment, if the type isn't provided, all service types are 
considered a match. For example, the type string may be "space" when operating on a large network or "service" 
15 when operating in a proximity network. Additional levels of type may be employed. 

Thus, as indicated at 2072 in Fig. 42, the service name and/or service type search criteria may be compared 
to name and type infonnation for services withm me dis^ Each service providerthat 

receives the search message may perform this comparison. Or a listener agent may perform the comparison for 
services registered with the listener agent 
20 The optional search criteria components may also include a comment (e.g. String). The comment string 

may be returned in the body of the response message, and may be a useful discovery message tracking tooL For 
example, a timestamp might be a useful comment string. 

A search response may then be returned to the client indicating advertisements for services that match the 
search criteria. The following is an example for one embodiment of a service provider response message that may 
25 be sent (e.g. unicast) by a service provider in response to the search message: 

<Oiscover> 
<5earchResponse> 

<SearchComment> Comment String<VSearchComment> 
30 <^dvertisement> Advertisementl </Advertisement> 

<Advertisement> Advertisement2 </Advertisement> 

<Advertisement> AdvertisementN ^Advertisements 
<SearchResponse> 
</Discover> 



35 



The response message may include the set of advertisements that match the search criteria. In one 
embodiment, if the search criteria weren't ^ 

emolument, if a comment string was supplied, the response also contains that same comment, possibly with an 
additional comment appended to the end of the original string. 
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As mentioned above, a service may publish either a protected advertisement or a complete advertisement 
Thus the advertisements indicated in a response to a search may be protected or complete advertisements. A 
protected advertisement may not indicate the actual URI or schema that may be used to access the service. Instead, 
a protected advertisement may contain information on how to obtain a complete advertisement that includes the URI 
5 and schema to access some or all of a. service's capabilities. In one embodiment, a protected advertisement may 
include the following information: 

• Name and type of the service. 

• Capability descriptions of the service. 

• UUID of the service. 

10 • URI of authentication service, which will return a suitable cUent acce« (capability) credential 

• URI where the credential and UUID may be sent to generate a complete service advertisement. 

A protected advertisement may be a smaller, surrogate XML document fragment (a meta-advertisement). 
A protected advertisement may provide a level of indirection between the client and the real advertisement, 
requiring the client to negotiate for access to the real advertisement Publishing a protected advertisement instead of 

15 a complete advertisement forces the client to obtain a valid credential from an authentication service before 
receiving the complete un-protected advertisement from the service provider. 

Returning to Fig. 41, after the client receives a response to it s search, it may select one of the 
advertisements for one of the services for which it wishes to negotiate access by requesting a capability credential, 
as indicated at 2074. This advertisement negotiation process may provide additional security in the distributed 

20 computing environment (e.g. by hiding real advertisements), while at the same time adding some flexibility. For 
example, during the advertisement negotiation process, a client may request a custom set of messages for accessing 
the service. The client may provide the desired name and type of interface. One example of requesting a custom set 
of messages may be requesting only "read" access as opposed to "read" and "write" access to a service. When 
requesting a custom message set, the client may wish to only use a subset of the service's full capabilities 

25 (messages). The right to use the requested set of messages may be verified during the negotiation. If the client 
doesn't have the proper access rights to the requested capabilities, the. negotiation fails, otherwise a valid credential 
is returned to the client 

A client may also request additional access message sets. Client may provide the desired name and type of 
interface. Some clients may require the use of more than just the base access messages. A client may request a set 
30 of additional access messages. Some of these access messages may even address platform specific issues such as 
performance and memory footprint size. 

A client may also request that a non-XML content type be used to represent data passed in the messages 
between client and service. Some clients may not support XML, but still wish to access services within the 
distributed computing environment To allow non-XML clients access to services, non-XML content may be 
35 tunneled within an XML message. The non-XML content may be wrapped by an XML tag on the sending side, and 
men extracted on me receiving side. 

Service providers may benefit from the use of protected advertisements in several ways. As already 
mentioned, protected advertisements prevent unauthorized clients from receiving complete advertisements, and 
allow capability negotiation. Protected advertisements may also allow for dynamic advertisement generation. When 
40 a client negotiates for a complete advertisement, an oprx>rtunity to generate a custom one "on the fly" exists. This 
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feature allows smaller XML document fragments to be downloaded to clients since the complete advertisement need 
be only as big as requested. This feature also allows a service to effectively publish advertisements specific to client 
requirements. 

Protected advertisements may also facilitate service queries. Protected advertisements may be published 
5 instead of complete advertisements to facilitate dynamic searches for services that match the client requested set of 
capabilities. Protected advertisements may indicate a service's capabilities in a searchable format without including 
a complete message schema for those facilities. 

In one embodiment, a protected advertisement may mclude the following XML document elements: 

• Name (Human readable, non-canonical string) 
10 • Canonical name of service (e.g. UUID) 

• Base Method Interface Description (Message Interface Description) 

- Title (Message interface standard name that conveys a type) 
— Provider Name (Standards Body Name) 

—Version (Version of standard (type) implemented) 
15 - Info URI (Standard body's web page) 

• Additional Access Method Interface Descriptions 

- List of descriptions containing: Title, Provider, Version, Info URL 

• Content Type Descriptions 

- List of descriptions containing: Title, Provider, Version, Info URL 
20 • Credential 

- Service's credential to enable client to authenticate service 

• Authentication URI 

- A message may be sent here to obtain a suitable credential that grants access to this service. 

• Generate Real Advertisement URI 

25 - A message may be sent here to generate a complete advertisement, given a protected advertisement 

that contains the client's requested capabilities. 
To obtain a complete advertisement, given a protected advertisement, a client (e.g. client's gate factory) 
obtains a capability credential from the specified authentication service by sending a credential request message, as 
indicated at 2074 in Fig. 41 . The credential request message may be sent to an authenticated service URI specified 

30 in the advertisement for the service the client desires to access. When the client's request is received, a capability 
credential is generated, as indicated at 2075. The capability credential may be generated according to capabilities 
requested by the client and/or the client's level of authorization. The client then receives the capability credential in 
response to its request, as indicated at 2076. The response may contain the credential needed to generate the 
complete advertisement This credential may be the same credential that the client's gate includes in each message 

35 sent to the service. 

If the advertisement was a protected advertisement, the client then may send an advertisement request 
message amraining the capability credential and an identification (e.g. UUID) of the service to the second URI 
. specified in the protected advertisement, as indicated at 2078. The client men receives a complete advertisement, as 
indicated at 2080. The response to this second message is the complete advertisement of the specified service. If 
40 the advertisement indicated in the credential request was already a complete advertisement, 2078 and 2080 may be 
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skipped Figure 43 compares the difference in the discover process when the published advertisement is a complete 
advertisement versus a protected advertisement Returning to Fig. 42, a complete advertisement and the capability 
credential may then be used to create a gate, as indicated at 2082. 

An example of a credential request message according to one embodiment is as follows: 

5 

<Discover> 
<CredentiaIRequest> 

<UUID> uuid</UU!D> 

<AdvertisementURJ>adv uri<yAcrvertisementURI> 
10 <Protecteoj\dvertisement> adv</ProtectedAoVertisement> 

<CredentialRequest> 
</Discover> 

The credential request message may include an identification (e.g. TJU1D) of service to which access is 
15 desired The credential request message may also include an advertisement TJRI referencing the advertisement or 
the advertisement (by value). The Advertisement may be passed by value or by reference during this negotiation 
process. Advertisements may be complete or protected If the advertisement passed in the credential request 
message is already a complete advertisement (e.g. service returned it in the search response), then the credential 
returned from the service will allow access to all of the service's capabilities (all access methods + all messages). 
20 A protected advertisement may be edited to contain just the desired set of access method and content 

descriptions. The edited protected advertisement may be passed in the credential request message. Thus, a client 
may build and expresses its set of requested capabilities by editing the advertisement, or copying the relevant 
information from the original to a new instance. 

An example of a credential request response message according to one embodiment is as follows: 

25 

<Discover> 

<CredentialRequestResponse> 

<Credentia>capability credentiaWGedential> 
</CredentialRequestResponse> 
30 <VDiscover> 

If the client has proper authorization, the credential request response message includes a capability 
credential giving the client requested access to the specified service (e.g. identified by UUID), including the set of 
capabilities defined in the protected advertisement This credential may men be stored in the client's gate and then 
35 added to each message sent to the service. The service then uses mis credential to verify the client's right to use a 
service's capabilities. 

The capability credential structure and contents may be defined by the service. In one embodiment, the 
credential at least includes a reference to the protected advertisement used during the negotiation, and a security key 
to validate the client's identity. If the advertisement passed in the credential request message is already a complete 
40 advertisement (e.g. service returned it in the search response), men the credential returned from the service will 
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. allow access to all of the service's capabilities. If the service provider doesn't support or require credentials at all, 
the response message may contain an empty credential (null). 

In some embodiments, a capability credential may be used to support the notion of sessions. A service 
provider may embed a session ID within the credential, and be sure that the client gate will pass h (credential 
5 containing ID) to the service provider in each message. The entire credential may be defined by the service provider 
and hence may contain any number of fields, including a sessionID, or other demuxing IDs, etc. 

An example of an advertisement request message according to one embodiment is as follows: 

<Discover> 
10 <AdvertisementRequest> 

<Credentia> capability credential<K>edentia> 
</AdverdsementRequest> 
</Discover> 

15 The advertisement request message includes the credential from the credential request response message. 

In one embodiment, this credential includes enough information to identity the original protected advertisement 

An example of an advertisement request response message according to one embodiment is as follows: 

20 <Discover> 

<AdvertisementRequestResponse> 

<Advertisement> ConmleteAdvertisementl <Advertisement> 
<AdvertisementRequestResponse> 
<ZDiscover> 

25 

The advertisement request response message includes the complete advertisement referenced by the 
(edited) protected advertisement Note that the credential found in the complete advertisement may be the gate 
credential to be passed in every message. 

Spaces are implemented by services of type space. Discovering a space may be accomplished either by 
30 specifying the "space" type in the search criteria, or by parsing the set of search results, and then extracting all 
"space" advertisements. Spaces may be populated with advertisements (protected ox unprotected) using the above 
described discovery protocol The population may be initiated by the space service itself; or by another network 
service agent 

Once a space is discovered, its contents may be examined using standard space service navigation 
35 messages or as defined in the space service advertisement For each advertisement within the space, a client gate 
factory may build a gate (using the credential and advertisement request messages) to access the named service. 

In one embodiment, all advertisements (protected and complete) contain a service credential. Clients may. 
validate this credential before requesting a client capability credential. This procedure may prevent unauthorized 
services from publishing aoVertisements using the discovery protocol. 
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For one discovery protocol implementation example, the protocol may be on the wire data format, which 
may be implemented in many different ways depending on the transport beneath it The discovery protocol 
implementation may be defined in a platform binding. For example, a possible IP implementation may be one in 
which space services listen for UDP multicasts of space search messages. A client/service may multicast a space 
5 search message and waits for a response. Space services may unicast a space search response message containing an 
advertisement 

In one embodiment, the distributed computing environment may include a mechanism for tracking service 
discovery search requests and responses to the requests. In one embodiment, search request and response messages 
may include a field that may be used to include a string or an XML document In one embodiment, the string or 
10 XML document included in the field of a request message is also returned in the response message. In one 
embodiment, the string or XML document is required to be returned in the response message. In one embodiment, 
the string or XML document may include additional information inserted in or appended to the string or document 
when returned in the response message, m one embodiment, this mechanism may be used in debugging complex 
systems. In one embodiment, this mechanism may also provide to clients a method for choosing services to access 
15 by using the string or XML document to pass custom search information between a client and service that may only 
be understood by the client and service. 

For an example of fields in request and response messages, refer to the SearchComment field in the search 
and search response messages described above. 

For some devices that provide a service, the overhead of finding a space to advertise its service and 
20 maintain that advertisement is undesirable. In one embodiment rather than searching for and m aintaini n g a space or 
spaces to publish service advertisements, services on some devices may transmit their advertisements in response to 
connection requests. For example, a printer device with a printer service mat is available on a proximity basis may 
not maintain an advertisement in a space (on the device or. external to the device). Instead, when another device 
establishes a connection with the printer device (for example, a user with a laptop running a client desires to print a 
25 document), the printer service may transmit the service advertisement to provide the XML service schema for 
connecting to and running the service that provides printing functionality on the printer device. Also, some devices 
may only maintain advertisements for their services in a certain vicinity or local network. Such a device may not 
desire to support or may not have access to transports for broader accessibility. 

One example of a service device in which it may be desirable for the device to avoid or limit maintaining 
30 service advertisements in a space is a device whose functionality is available on a proximity basis. Proximity-based 
services may provide advertisements of their functionality upon request These advertisements may not be broadly 
accessible. For example, proximity-based services may be provided in a wireless communications system. The term 
"wireless" may refer to a communications, monitoring, or control system in which electromagnetic or acoustic 
waves carry a signal through atmospheric space rather man along a wire. In most wireless systems, radio frequency 
35 (RF) or infrared (IR) waves are used. Typically, in proximity-based wireless systems, a device comprising a 
transceiver must be within range (proximity) of another device to establish and maintain a communications channel. 
A device may be a hub to connect other devices to a wireless Local Area Network (LAN). 

As mentioned, embodiments of the distributed computing environment may provide a mechanism using one 
or more spaces that allow' clients to rendezvous with services. In a rmiximrty computing environment, one 
40 embodiment of the distributed computing environment may provide a service discovery mechanism mat clients may 
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use to discover services without using spaces as rendezvous points. An example of a proximity computing 
environment is an IrDA point-to-point communications environment. In a proximity computing environment, the 
proximity mechanism may find the "physical" location of the service for the client For example, in an IrDA 
environment, the client device may be physically pointed at the device including the service(s) that the client desires 
5 to use. 

In some situations a client may have physically discovered the device that contains services the client 
desires to run. For example, a person with a PDA client may be in close proximity to a printer participating within 
the distributed computing environment Various scenarios may emerge with close proximity devices. When clients 
are in close proximity to devices (e.g. publishing services), much of the discovery process may be simplified. In 
10 these cases, the user may select the device. For example, IRDA devices are pointed at each other to establish a 
discover connection. 

Close proximity devices for which security isn't an issue (like an IRDA printer) may publish complete 
advertisements. Instead of encapsulating services in spaces, close proximity devices may directly respond to the 
discovery protocol. 

15 Close proximity devices for which security is an issue (e.g. an ATM) may respond to discover requests 

with protected space advertisements. The space may contain all the services supported by the device. Once access 
to the space has been granted, clients may browse complete advertisements stored in the space. This model 
presumes that all services stored in the space can leverage the space security model, and not provide a separate 
modeL Alternatively, close proximity devices for which security is an issue may respond to discover requests with 
20 protected advertisements for each service. Each service may provide its own authentication service. Combinations 
of .each proximity device scenario are also contemplated. 

The proximity service discovery mechanism may enable the client to directly look for service 
advertisements rather than sending a search request to a space to look for service advertisements. Since the client 
device may have established a proximity connection to the service device, the client may directly request the desired 
25 service. For example, a PDA client device may establish a proximity connection to a printer device; the client may 
"know" to request a printer service connection on the printer device. 

In one embodiment, the client may send a proximity service discovery message to the service device. The 
message may include information that may specify a desired service on the service device to which the client device 
has a proximity connection. In one embodiment, a service on the service device may respond to the proximity 
30 service discovery message, and may send to the client the service advertisement that the client may use to connect to 
the desired service. The proximity service discovery message may also include information that may be used to 
authenticate the client and to establish the client's capabilities on the service. Using the received service 
advertisement, the client may establish a gate to establish communication with the desired service. 

An example of a system in which a client device directly discovers a service on a service device over a 
35 proximity link is illustrated in Fig. 44: A client device 2150 includes a proximity port (eg. an IrDA port) 2156 
configured to form a direct pomt-to-point communication link, or proximity link. Client device 2150 may include a 
client 2152 that may desire to use a service over the proximity link. The client 2150 may be an application or a 
combination of circuitry and software. A client interlace 2154 may be configured to directly request over the 
proximity link a document that describes an interrace to access a desired service. Hie interlace 2154 may also be 
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configured to receive such a document directly over the point-to-point communication link and use the information 
from the document to access the service, such as by constructing a gate. 

A service device 2170 may include a proximity port 2172 and may form a proximity link with client device 
2150. The service device 2170 may include code and/or hardware to implement one or more services 2176. 
Service device 2178 may also be configured to provide one or more documents 2178, or advertisements, over the 
proximity ImV An advertisement 2178 may describe a message schema for accessing a service 2176 provided by 
service device 2170. A service interface 2174 may be configured to receive over the proximity link a request from a 
client for a document 2178 mat describes an interface to access a service 2176. The interface 2174 may also be 
configured to provide document directly to a client over the proximity link and provide a message endpoint (e.g. 
gate) for communicating with a client The service interface may also provide a mechanism to authenticate clients* 
requests to access the service. 

Figure 45 illustrates a basic flow diagram fllustxating client discovery of a proximity service, A client may 
form a proximity connection to a service device, as indicated at 2190. For example, a client device may be a 
personal digital assistant (PDA) with an address book client The client my need to print a portion of the address 
book. The PDA may include an IrDA port and may be in proximity of a printer with an IrD A port The client may 
establish a TJroximity connection to the printer. The client may then, as indicated at 2192, request a service 
advertisement over the proximity connection, such as a printer service advertisement Then client may then receive 
an advertisement matching its request, as indicated at 2194. The advertisement may be received directly from the 
service device over the proximity connection. The client may then construct a gate according to the advertisement 
to access the service, as indicated at 2 196. 

Thus, proximity devices may avoid the overhead of using spaces as a rendezvous point for clients 
discovering services. Nevertheless, it may still be desirable to publish advertisements for services (e.g. proximity- 
based services) that do not desire to or cannot maintain their advertisements in a space that is broadly accessible. In 
one embodiment of a distributed computing environment, a device that establishes a connection with a device that 
does not publish its service advertisements), such as a proximity-based device, may publish service advertisements 
received from the non-publishing device. For example, a device that establishes a connection with a proximity- 
based device and that has an alternate transport connections) may publish (or republish) service advertisements 
received from the proximity-based device in the alternate transport environment, thus allowing the proximity-based 
device services) to be used by other devices (through the (republished service advertisements) which are outside 
the normal proximity range of the device. 

The publishing device may locate a locally published service advertisement for the proximity-based device 
through a discovery and/or lookup service, or alternatively the service advertisement may not be published by the 
local service device, but instead may be sent to the publishing device by the local device upon the establishment of a 
proxnnity connection, as described above. In one embodiment, the republished service advertisement may be made 
available as long as the device maintaining the advertisement is connected to or able to connect to the local device. 
For example, if the publishing device is disconnected from the local device (for example, moves out of proximity 
range of the device), the service advertisement may be made stale or removed. A lease mechanism may be provided 
to allow the space amtaming the advertisement to send lease renewal messages to the publishing device. The 
publishing device may verity its connection to the local device, thus allowing the space to detect when the local 
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device is no longer available. Rules for how the service advertisements are republished may be provided by the 
local device or by an adjriirustrative policy for the local vicinity (e.g. proximity area) or local network. 

Figure 24 illustrates an example of a device bridging proximity-based devices onto another transport 
mechanism to allow the services provided by the proximity-based devices to be accessed by devices outside the 

5 proximity range of the devices, according to one embodiment A publishing device 1404 may be connected to a 
network 1412, such as an Ethernet LAN or the Internet, etc., and may establish and maintain proximity connections 
1414 with proximity devices 1400 and 1404. Proximity connections may be wireless connections or wired LAN 
connections, for example. Proximity devices 1400 and 1402 may each send a service advertisement to the 
publishing device 1404 upon connection, or, alternatively, the publishing device may locate the service 

10 advertisements using a discovery and/or lookup service for the proximity connections. The publishing device 1404 
may then make the services provided by the proxirnrry devices available to other devices 1408 and 1410 on the 
network 1412 by republishing the service advertisements 1416 and 1418 in space 1406. Space 1406 may be stored 
on the publishing device or on other devices connected to the LAN (mcluding devices 1408 and 1410). 

Other devices on the LAN including devices 1408 and 1410 may then discover space 1406 and look up the 

15 republished service advertisements 1416 and 1418 for the proximity-based devices, establish gates to communicate 
to those services (device 1404 may act as a proxy or bridge) on the rroximrty-based devices 1400 and 1402 using 
the XML message passing methods described previously, and send requests and receive results to the proximity 
devices. Publishing device 1404 may act as a bridge between the network 1412 and the proximity connections 1414 
to the proximity-based devices. 

20 

Matching Component (Service) Interfaces 

The distributed computing environment may provide a mechanism for matching a component (for example, 
a service) specification interface with a requested interface. For example, a client (which may be a service) may 
desire a service that meets a set of interface requirements. Each component may have a description of the interlace 

25 to which it conforms. The specification interface matching mechanism may allow a component that best matches a 
requestor's interface requirements to be located. The specification interface matching mechanism may also allow 
for 'fuzzy" matching of interface requirements. In other words, the mechanism may allow matching without 
requiring the exact specification of all aspects of the interface, thus providing a nearest match (fuzzy) mechanism. 
In one embodiment, the specification interface matching mechanism may be implemented as a multi-level, sub- 

30. classing model rather than requiring specification at a single interface leveL 

In one embodiment, a component may use an XML Schema Definition Language (XSDL) to describe its 
interface. XSDL may provide a human-interpretable language for describing the interface, sirnplirying activities 
requiring human intervention such as debugging. In one embodiment, the interface description may be provided as 
part of an advertisement (for example, a service advertisement) as described elsewhere in mis document 

35 Using the specification interface matching mechanism, a basic desired interface may be compared to a set 

of component' interface descriptions. One or more components matching the basic desired interface may be 
identified. The interface descriptions may include subclass descriptions describing more specifically the interfaces 
provided by the components. In the search process, the class type hierarchy may be examined to determine if a 
given class is a subclass of the search type. In one embodiment, subclasses may inherit properties of the base class, 

40 and thus the subclass-specific information may not be examined in this phase. Thus, the search may be performed 
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generically. The identified components may be searched at the next (subclass) leveL The search may become 
specific to the subclass and may be performed by interpreting the subclass information included in the interface 
description. The search may continue through one or more subclasses until one or more components is determined 
which may provide the nearest match to the requestor's desired interface. 
5 In one embodiment, an interface matching mechanism may provide the ability to distinguish among two or 

more components that implement similar interfaces. In one embodiment, the interface matching mechanism may 
provide the ability to distinguish among different revisions of the same component 

In one embo dime nt, a component description may be provided that includes a specification of the interface 
to which the component conforms. The component description may also include mformation about the component 
10 itself The interface description and/or the component mformation may be used to differentiate ainong different 
implementations of a given interface. The component descriptions may include a canonical identifier and version 
information. The version information may allow component revisions to be distinguished. In one embodiment, the 
component description may be provided as part of an advertisement (for example, a service advertisement) as 
described elsewhere in this document 
15 in one embodiment, components may be searched for a particular canonical identifier. Two or more 

components may be identified with matching canonical identifiers. One or more components may be selected from 
among the components with matching canonical identifiers. The selection procedure may use an interface 
specification version, a component implementation specification, a component implementation specification version, 
other mformation or a combination of information from the component description to produce a set of one or more 
20 components that best match the requestor's requirements. 

Spaces 

As mentioned above, the distributed computing environment relies on spaces to provide a rendezvous 
mechanism that brokers services or content to clients. Figure 15 illustrates the basic use of a space 114. Service 

25 providers may advertise services in a space 1 14. Clients 110 may find the advertisements in a space 1 14 and use the 
infonnation from an advertisement to access a service using the XML messaging mechanism of the distributed 
computing environment Many spaces may exist, each containing XML advertisements that describe services or 
content Thus, a space may be a repository of XML advertisements of services and/or XML data, which may be raw 
data or advertisements for data, such as results. 

30 A space itself is a service. Like any service, a space has an advertisement, which a client of the space must 

first obtain in order to be able to run that space service. A space's own advertisement may include an XML schema, 
a credential or credentials, and a URI which indicate how to access the space. A client may construct a gate from a 
space service's advertisement in order to access the space. A client of a space may itself be a service provider 
seeking to advertise in that space or modify an existing advertisement Or a client of a space may be an appfication 

35 seeking to access a service or content listed by the space. Thus, spaces may provide catalysts for the mteraction 
between clients and services in the distributed computing environment 

A space may be a collection of named advertisements. In one embodiment, naming an advertisement is the 
process of associating a name string with an advertisement The association may take place upon storing an 
advertisement in a space. Removing an advertisement from a space disassociates the name from the advertisement 

40 A space may be created with a single root advertisement that describes the space itself Additional advertisements 
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may be added to a space. An advertisement's name may locate the advertisement within the space, including 
specifying any necessary graphing information such as a hierarchy of names. In a preferred embodiment, the 
distributed computing environment does not dictate the structure of a space. That is, spaces may be structured as, 
for example, a flat un-related set of advertisements or a graph of related advertisements (e.g. commercial database). 
5 Since, in a preferred embodiment, the distributed computing environment does not dictate how a space actually 
stores, its content, spaces may be supported by small to large devices. For example, a simple space may be tailored 
to fit on small devices, such as PDAs. More advanced spaces may be implemented on large severs employing large 
commercial databases. 

As mentioned above, a space may contain advertisements for services in the distributed computing 
10 environment An advertisement may provide a mechanism for addressing and accessing services and/or content 
whhin the distributed computing envinmment An advertisement may specify a URI for a service. In some 
embodiments, the URI may allow tor the service to be accessible over the Internet An advertisement may also 
include an XML schema for the service. The XML schema may specify a set of messages that clients of the service 
may send to the service to invoke functionality of the service. The XML schema may define the client-service 
15 interface. Together, the URI and the XML specified in an advertisement may indicate how to address and access the 
service. Both the URI and schema may be provided in XML as an advertisement in a space. Thus, a mechanism for 
addressing and accessing a service in a distributed computing environment may be published as an advertisement in 
a space. Clients may discover a space and then lookup individual advertisement for services or content 

Figure 16 illustrates advertisement structure according to one embodiment An advertisement 500, like 
20 other XML documents, may include a series of hierarchically arranged elements 502. Each element 502 may 
include its data or additional elements. An element may also have attributes 504. Attributes may be name-value 
string pairs. Attributes may store meta-data, which may facilitate describing the data within the element 

In some embodiments, an advertisement may exist in different distinct states. One such state may be a 
drafted state. In one embodiment, advertisements may initially be constructed in a drafted state that exists outside 
25 the bounds of a space. The creator of an advertisement may construct it in a variety of ways, including using an 
XML editor. Access to elements and attributes in the drafted state may be at the raw data and meta-data levels using 
any suitable means. Typically, events are not. produced for changes made to advertisements in the drafted state. 
Therefore, the creator of the advertisement may be free to add, change, or delete elements as well as to achieve the 
desired attribute set, and then publish the advertisement for the rest of the distributed computing environment to see, 
30 In one embodiment, another possible state for advertisements is a published state. Advertisements may 

move to the published state when inserted into a space. Once the advertisement is in a space, interested clients, and 
services may locate it, e.g. using its name and/or its elements as search criteria. For example, search criteria may be 
specified as an XML template document that may be compared (e.g. by the space service) with the advertisements in 
the space. Published advertisements may represent "on-line" services ready for clients to use. The message address 
35 (URI) of the service may be stored as an element in the advertisement Advertisements mat are removed from the 
space may transition back to the drafted state where they may be discarded or held. Removal may generate an event 
so interested listeners may be made aware of the change. Message gates are typically created from published 
advertisements. . 

In one embodiment, yet another possible state for advertisements is a persistent archived state. An archival 
40 procedure may turn a live published advertisement into a stream of bytes that may be persistently stored for later 
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reconstruction. Archived advertisements may be sent (e.g. in their raw XML form) from the space to an archival 
service. The UKI for an advertisement's archival service may be stored as an element in the advertisement XML 
may provide a format for storing and retrieving advertisements and representing the state of advertisement elements 
sufficient to reconstruct the advertisement object(s). Advertisements may be stored in other formats as well, 

5 depending on archival service implementation. The process of making a published advertisement persistent may 
prepare die advertisement for the persistent archived state. Persistent advertisements may be stored (e.g. by an 
archival service) for future use in a persistent storage location such as a file or a database. A space through the 
archival procedure may enable advertisements to be stored, however the space does not necessarily play a role in 
how persisted advertisement entries are actually stored. How persisted advertisements are stored may be deterrnined 

10 by the advertisement's archival service. Typically, no events are generated on behalf of archived advertisements. 
Also, changes may not be allowed for advertisements in the persistent archived state. 

Advertisements may be archived and removed or just archived If an advertisement is archived without 
removing it from the space, the space will store a shadow version of the advertisement Access to an archived 
service may cause the advertisement to '"fault-in" from its persistent backing store on demand. This feature may 

15 allow advertisements to be filled, from LDAP (Lightweight Directory Access Protocol) entries for example, on 
demand. 

Figure 17 illustrates one example of advertisement state transitions that an advertisement may undergo 
during its lifetime. First, an advertisement may be constructed, as indicated at 1. During construction, the 
advertisement is in the drafted state. Then, the advertisement may be inserted in a space, as indicted at 2. The 

20 advertisement may be inserted as a published parent The advertisement is in the published state after being inserted 
in a space. An event (e.g. AdvInsertEvent) may be generated when the advertisement is inserted in the space. 
Events are more fully discussed below. The advertisement may be archived and made persistent, as indicated at 3, 
which may transition the advertisement to the persistent archived state. An advertisement may also be published 
from the persistent archive state, as indicated at 4. An advertisement may be removed from a space and transition 

25 back to the drafted state, as indicated at 5 r An event (e.g! AdvRemoveEvent) may be generated when the 
advertisement is removed. 

In one embodiment, the archived, persistent state is not used. In this embodiment, state changes 3 and 4 
also are not used. In this embodiment, an advertisement is either in the drafted state or in the published state. . 

Advertisements stored in a space may have the following standardized elements and/or attributes: version 
30 (may be an element), creation date (may be an attribute), modification date (may be an attribute), implementation 
service URI (may be an element), and/or persistence archival service URI (may be an element). 

A space itself is typically a service. A space service may provide the ability to search for advertisements in 
the space, which may include searching the space by type of advertisements. A space service may also provide 
facilities to read advertisements, write (publish) advertisements, and take (remove) advertisements. A space may 
35 also provide the ability to subscribe for space event notification messages. Some spaces may provide extended 
facilities, such as mcflities to navigate space relationship graph by position; read, write or take advertisement 
elements; read, write or take advertisement attributes; and subscribe for advertisement event notification messages. 
Space facilities are described in more detail below. A space's capabilities are embodied in a space advertisement's 
message schema. From the message schema, space address, and authentication credential, a client message gate may 
40 be created to access the space and its facilities. 
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Spaces and all advertisements within a space may be addressed using URIs. In one embodiment, space and 
advertisement names may follow URL naming conventions. The use of URIs, e.g. URLs, for addressing spaces may 
allow spaces to be addressable throughout the Internet, in some embodiments. 

The space message recipient (a space service) may be specified using a URI which may have been received 

5 hi a service advertisement for the space. The URI may include a protocol, host, port number, and name. The 
protocol may name the protocol that may be used to move messages between clients and the space (reliable or 
un-reliable sockets, for example). The host and port number may be protocol dependent IDs. The name may be the 
space name followed by advertisement, element and/or attribute name. In one embodiment, a pathname may be 
used to identify an advertisement in a space. Pathnames may be either absolute or relative. Absolute pathnames 

10 name the space as well as an advertisement Relative pathnames are relative a designated advertisement within an 
assumed space. In one embodiment, the syntax rules governing the construction of pathnames is that of the URI 
(Uniform Resource Identifier), In that embodiment, advertisement and space names therefore may not contain any 
URI reserved characters or sequences of characters. Pathnames to elements and attributes may also be specified 
using a URI. In general, element and attribute names may be appended to the pathname of an advertisement, such 

15 as: 

htrp://]ava.sun.com/spacename^ 

In one embodiment, the distributed computing environment may include a mechanism that allows a client 
to discover the URI of a space but restricts access to the service advertisement for the space. In one embodiment, 
rather than returning the full advertisement to the space, the URI of the space and the URI of an authentication 

20 service for the space may be returned. In order for the client to access the documents or services advertised in the 
space, the client first may authenticate itself to the authentication service at the URI provided in the return message. 
The authentication service may then return an authentication credential that may allow the client partial or full 
access to the space. When the client receives the authentication credential, the client may attempt to connect to the 
space to access the documents or service advertisements in the space. 

25 The distributed computing environment may provide a mechanism or mechanisms that may enable a client 

to connect to a space. Embodiments of a connection mechanism may provide for client-space addressing, client 
authorization, security, leasing, client capabilities determination, and client-space connection management A 
client-space connection may be referred to as a session. In one embodiment, a session may be assigned a unique 
session identification number (session ID). The session ID may uniquely identify a client-space connection. In one 

30 embodiment, a session lease mechanism may be used to transparently garbage collect the session if the client does 
not renew the lease. 

Hie following is an example of using such a connection mechanism according to one embodiment A 
client may obtain an authentication credential In one embodiment, the space may provide an authentication service 
in response to a client's request for access to the space. The client may obtain the authentication credential through 

35 the amtentication service. When the client receives the anthentication credential, the client may initiate a 
connection to the space by sending a connection request message. In one embodiment, the connection request 
message may include the URI address of the space service, the authentication credential for the client and 
information about the connection lease the client is requesting. After the space receives the connection request 
message, the space may validate the message. In one embodiment, an XML schema may be used to validate the 

40 message. The client may then be authenticated using the aumentication credentiaL In one embo diment , the 
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information received in the connection request message may be used to determine the capabilities of the client to use 
the space. In one embodiment, each client of a space may be assigned its own set of capabilities for using the space. 
In one embodiment, an access control list (ACL) that may include capability information about one or more clients 
of the space may be used in client capabilities determination. In one embodiment, the information received in the 
5 connection request message may be used to look up the client's capabilities in the ACL. 

After authenticating the client and determining the client's capabilities, the connection lease to grant the 
client may be determined. After the lease is determined, the structure for mamtaining the client-space connection 
may be generated. A session ID for the connection may be generated. In one embodiment, each client-space 
connection may be assigned a unique session ID. In one embodiment, an activation space may be created and 
10 assigned to, or alternatively a pre-existing activation space may be assigned to, the client-space session. In one 
embodiment, an activation space may be used to store results of services for the client when using the space. In one 
embodiment, a client's capabilities may be used to determine if an activation space is to be created for the client 
For example, a client may not have capabilities to access an activation space to store and retrieve results. A message 
or messages may be sent to the client infonning the client that the connection has been established. The message or 
15 messages may include the session ID and information about the lease. The client may then use the space including, 
but not limited to: advertisement lookup, advertisement registering, and advertisement retrieval. In one 
embodiment, he connection may remain open until the allocated lease expires or until the client sends a message 
requesting lease cancellation to the space. In one embodiment, the client may be responsible for renewing the lease 
before the lease expires. If the lease expires before the client renews the lease, the connection may be dropped, 
20 causing the client to lose the connection to the space. In one embodiment, to reconnect, the client may be required 
to repeat the connection procedure. 

In one embodiment, a client of a space may obtain a space's advertisement several different ways. Some of 
the ways a client may obtain a space's advertisement are illustrated in Figure 18. For example, a space discovery 
protocol may be provided as part of the distributed computing environment Space discovery is a protocol a client 
25 or service may use to find a space. A listener agent 202 may be configured associated with one or more spaces to 
listen for discovery requests. The discovery listener agent 202 may listen on various network interfaces, and may 
receive either broadcast requests or unicast requests (at the URI of the agent) from clients 200a looking for a 
space(s). The listener agent 202 then responds with the service advertisements) or URIs for the service 
advertisements of the requested space(s). In one embodiment, the listener agent is, in general, separate from the 
30 space, because its fimctionality is orthogonal to the functionality of a space service. However, the listener agent 
may be implemented on the same device or a different device as a space service. 

In one embodiment, the discovery protocol may be a service advertised in a default space. A client may 
instantiate the discovery protocol from the client's default space in order to discover additional spaces. The 
discovery protocol may be pre-registered with a client's default space. Alternatively, the discovery protocol may 
35 register itself with the default space by placing an advertisement in that space, e.g^ when a client connects to a local 
network serviced by the discovery service. 

In one embodiment, the space discovery protocol may be mapped to underlying device discovery protocols 
for other platforms, such as SLP, Jini, UPnP, etc. Thus, a client may use the discovery protocol of the distributed 
computing environment to find services in other environments. A bridge to these other environments may be 
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provided, and advertisements provided to services in these other environments so that clients of the distributed 
computing environment described herein may access them. Refer to the Bridging section. 

For each advertised discovery protocol, the distributed computing environment may create a subsequent 
results space to hold the results of the discovery protocol. In one embodiment, space services in the distributed 
S computing environment may use the Multicast Announcement Protocol (multicast UDP) to announce themselves on 
a LAN. A listener agent may record this information. A device (either a client or service) may use the Multicast 
Request Protocol (multicast UDP) to initiate discovery of a space manager. In one embodiment, the space managers 
respond with informatioh indicating the URI of their respective spaces. Alternatively, a listener agent may respond 
for multiple spaces. The discovery response may also include a short string that labels the each space (e.g. obtained 
10 from keywords of the space), and information that can be used to set up a TCP connection, for example, with each 
space manager to perform operations on the respective space. Since the requesting device may receive responses 
from more man one space manager (or multiple space listings from a listener agent), this information may help the 
client select which space it wishes to connect to. 

In addition to the multicast discovery described above, the discovery service may also perform discovery 
15 using unicast messaging (e.g. over TCP) that can be used to discover a space manager at a known address on the 
network (e.g. the Internet, other WAN, LAN, etc). The unicast discovery message may include a request for a space 
service at a known URI to provide its service advertisement The multicast and unicast discovery protocols are 
defined at the message level, and thus may be used regardless of whether the devices participating in the discovery 
support Java or any other particular language. 
20 .The discovery protocol may facilitate the proliferation of clients independently of the proliferation of 

server content that supports those clients within the distributed computing environment For example, a mobile 
client may have its initial default space built into its local platform. In addition to local services advertised in the 
defeult space, the mobile client may have services that search for additional spaces, such as a service to access the 
discovery protocol or a service to access space search engines. 
25 In one embodiment, die distributed computing environment space discovery protocol may define a set of 

XML messages and their responses that may allow clients to: 

Broadcast protocol-defined space discovery messages on their network interfaces. 
• Receive from listeners XML messages describing candidate spaces mat those listeners 



30 



• Select one of those discovered spaces as default, without the client needing to know the 
address of the selected space. 

• Obtain information on the selected space, such as its address, so the client may later find that 
same space via means outside of the discovery protocol (useful if later the client wants to 
access a space which is no longer local, but which still is of interest to the client). 

35 In some embodiments, the multicast and unicast discovery protocols may require an IP network. Although 

these discovery protocols meet the needs of devices that are TP network capable, there are many devices mat may 
not be directly supported by these discovery protocols. To meet the needs of such devices in discovering spaces in 
the distributed computing environment, a pre-discovery protocol may used to find an IP network capable agent The 
pre-discovery protocol may include the device sending a message on a non-IP network interface requesting a 

40 network agent The network agent may set up a connection between itself and the device. Once the connection 



46 



WO 01/86394 PCTAJS01/15134 

between device and agent is set up, the agent participates in the discovery protocol on IP networks on behalf of the 
device for which it serves as agent The network agent may also provide an mterfece for the device to the 
distributed computing environment in general For example, gates may be constructed in the agent on behalf of the 
device for nmning services advertised in discovered spaces. See the Bridging section. 
5 Another way that clients may locate spaces in the distributed computing environment is by advertisement of 

a space in another space. A space is a service, thereforeso, like any other service, it can be advertised in another 
space. As shown in Figure 18, a client 200b may find an advertisement 206 in a first space 204a for a second space 
204b. Space 204b may in turn include advertisements to additional spaces. Because a service (implementing a 
space) may also act as a client, spaces may exchange advertisements or chain together to provide a federation of 
10 spaces, as illustrated in Figure 19. Any number of spaces may be included in the clistributed computing 
environment The number and topology of spaces may be implementation dependent For example, spaces 
implemented on an IP network might each correspond to a Querent subnet 

A third way a cfientinay locate a space btionmg^ A service 

208 may be run which returns as its results the service advertisements of space services. Since service 
15 advertisements are XML documents and since the distributed computing environment may include the Internet, 
service 208 may be a Web-based search tooL An example of such a service is the space look-up service described 
in conjunction with Figure 4. In one embodiment, spaces within the distributed compirting environment may be 
implemented as Web pages. Each Web page space may include a keyword mat may be searched upon to identity 
the Web page as a space in the distributed computing environment The space may include other searchable 
20 keywords as well to further define the space. A client may connect to a search service 208 and supply keywords to 
the search service in the form of XML messages. The search service may receive the keywords from the client and 
feed the keywords to an Internet search engine, which may be a conventional or third-party search engine. The 
search service may return the results from the Internet search engine to the client, either directly as XML messages 
or by reference to a results space. Hie results may be the URIs of spaces rriatching the search request 
25 Alternatively, the search service may contact spaces identified by the search, obtain the service advertisement for 
each such space, and return the space service advertisements to the client, either directly as XML messages or by 
reference to a results space. The client may then select a space from the search results and construct a gate (by itself 
or through a proxy) to access the selected space. Once the selected space is accessed, the client may look up service 
advertisements within that space, which may lead to additional spaces. 
30 As described above, a space may be an XML-based Website, and as such may be searched via Internet 

Web search mechanisms. A space may include Internet searchable keywords. Some devices, such as small client 
devices, may not support an Internet browser. However, such devices may still perform Internet searches for spaces 
within the distributed computing environment A device may have a program mat accepts strings of keywords, 
which may be sent to a proxy program on a server (e.g. a search service). The proxy may send the strings to a 
35 browser-based search facility (e.g an internet search facility) to perform the search. The proxy may receive the 
output of the search and parse it into strings (e.g. XML strings) representing each URI for the search results and 
send the response strings back to the client Thus, a client may locate spaces through the Internet without having to 
support a program such as a Web browser: More capable devices may avoid the use of a proxy and mitiate an 
Internet-based search service directly. 
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A fourth way a client may locate a space is by obtaining or receiving information about a newly created 
empty space or a spawned space when an existing space is spawned. An existing space may include an interface for 
spawning an empty space with the same functionality (e.g. same XML schema) as the space from which it is 
spawned. Spawning of spaces is further described below. 

5 Once a client of a space finds the advertisement of a space service, that client of the space may run the 

space service, as it would any other service. Note that the client of the space service may be another service (e.g. a 
service seeking to advertise in the space). In one embodiment, as illustrated in Figure 20, to run a space service, the 
client of the space may first run an authentication service for the space to obtain an authentication credential, as 
indicated at 300. The authentication service may be specified in the service advertisement of the space service. The 

10 client of the space uses the authentication credential, the XML schema of the space (from space's service 
advertisement), and the URI of the space (from space's service advertisement) to construct a gate for the space, as 
indicated at 302. The client of the space may then run the space service by using the gate to send messages to the 
space service. A first such message is indicated at 304. 

For embodiments employing authentication, when the space service receives the first message from the 

15 client, with the authentication credential embedded, the space service uses the same authentication service (specified 
in the service advertisement of the space service) to authenticate the client, thus establishing its identity, as indicated 
at 306. The space service may determine the clients capabilities and bind them to the authentication credential, as 
indicated at 308. 

As indicated at 3 10, a client of a space may run various space facilities by sending messages to the space 

20 service. In one embodiment, when a client of a space sends a request to the space service, it passes its authentication 
credential in that request, so the space service can check the request against the client's specific capabilities. 

Each space is typically a service and may have an XML schema defining the core functionality of the space 
service. The XML schema may specify the client interface to the space service. In one embodiment, all space 
services may provide a base-level of space-related messages. The base-level space functionality may be the basic 

25 space functionality that is capable of being used by most clients, including small devices such as PDAs. It may be 
desirable to provide for additional functionality, e.g. for more advanced clients. Extensions to the base-level space 
may be accomplished by adding more messages to the XML schema that advertises the space. For example, in one 
embodiment, the base-level messages do not impose any relationship graph upon the advertisements. Messages, for 
example, to traverse a hierarchy of advertisements may be a space extension. Such additional functionality may be 

30 provided through one or more extended XML space schemas or schema extensions for a space. The extended 
schemas may include the base schema so that clients of an extended space may still access the space as a base space. 
In one embodiment, a base space service may provide a transient repository of XML documents (e.g. 
advertisements of services, results of nmning services). However, a base space service in one embodiment may not 
provide for advanced facilities to support persistence of space content, navigation or creation of space structure (e.g. 

35 hierarchy), and a transactional model. A mechanism for supporting persistence, hierarchy, and/or transactions is by 
extending the XML schema. Since extended spaces still include the base XML schema, clients may still treat 
extended spaces as base spaces, when just the base space functionality is all that is need or all that can be supported. 

In one embodiment, the base space may be transient Hie base .space may be acceptable for many 
purposes. Service providers may register their services in various spaces. In one embodiment, services must 

40 continuously renew leases on the publishing of information in the spaces. By this nature, the services 
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advertisements may be transient in that they may often be rebuilt and/or reconfirmed. However, it may be desirable 
to provide for some persistence in a space. For example, a space that has results may provide some persistence for 
users that want to be sure that results are not lost for some time. In one embodiment, persistence may be provided 
for by specifying a space interface where the client may control which objects in the space are backed by a persistent 
5 store and manage the maintenance of that persistence store. The persistence interface may be specified with 
extended XML schema for the space defining the mterfeces for persistence. 

In one embodiment, a base space may provide an interface where an XML document may be added to a 
space and identified by a string. The base space may not provide any hierarchy for the various so named XML 
documents in the space. In embodiments where hierarchy support is desired, additional interlaces may be defined 
10 (extending the XML schema) where the user can specify a m'erarchy. Other interfaces may be specified to navigate 
the hierarchy or navigate a relationship graph by position. However, other users may still use the base space 
interfaces to access those same documents, without any hierarchy. Interfaces for other space structure may be 
provided for as well in extended space schemas. 

Extended XML space interfaces may also be provided for space transaction models. For example, an 
15 extended space XML schema may be provided specifying an interface for ACID transactions. ACID is an acronym 
used to describe four properties of an enterprise-level transaction. ACID stands for Atomicity, Consistency, 
Isolation, and Durability. Atomicity means that a transaction should be done or undone completely. In the event of 
a failure, all operations and procedures should be undone, and all data should rollback to its previous state. 
Consistency means that a transaction should transform a system from one consistent state to another consistent state. 
20 Isolation means that each transaction should happen independently of other transactions occurring at the same time. 
Durability means that completed transactions should remain permanent, e.g. even during system failure. Other 
transaction models may also be specified in extended space schemas. 

Extended space schemas may be XML documents that specify the message interlace (e.g. XML messages) 
for using extended space features, functionality or facilities. A space may have a base schema and multiple 
25 extended schemas. This may facilitate provided different levels of service to different clients depending upon the 
client authentication. 

Besides extensions for space persistence, structure, and transactions, other space extensions may also be 
specified as desired. For example, extensions may be provided to manipulate advertisements at the element or 
attribute level: read, write or take advertisement elements; read, write or take advertisement attributes; and subscribe 
30 for advertisement event notification messages. A space may provide virtually any number of facilities and arrange 
them in base and extended schemas as desired. In one embodiment, all base spaces must provide for advertisement 
reading, writing, taking, and lookup facilities, and space event subscriptions. 

Various space facilities may be provided. In. some embodiments, a facility may be provided for the 
establishment of a session with the space. In one such embodiment, the rest of the space functionality is not 
35 available until this is done. In other embodiments, the notion of a session is not provided for, or is optional and/or 
implementation dependent. , 

Another space facility may be to add or remove a service advertisement to or from the space, A space 
facility may also be provided for adding or removing an XML document (not an advertisement, but perhaps a result 
in a space). The space service may check for uniqueness of an hem before allowing the addition of the item. For 
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example, each hem added to the space may be associated with a user-specified string mat identifies the item and that 
may be used to check for the uniqueness of the item. 

In one embodiment, a client may request a listing, tree or other representation of all services advertised in 
the space. The user then may scroll or maneuver through the advertisements and select the desired service. A space 
may also provide a look-up fecility that allows a client to search for a service by providing keywords or string 
names. In one embodiment, a space facility may provide a mechanism to look up a space entry that has been added 
to the space. The look up faculty may search by string to match for name, or wildcard, or even database query. The 
look up facility may return multiple entries from which the client may select one or perform a further narrowing 
search. In one embodiment, the look-up facility may provide a mechanism to locate a service advertisement 
matching a particular XML schema. The client may indicate a particular XML schema, or part of a particular XML, 
to be searched for within the space. Thus, a service may be searched for within a space according to its interface 
functionality. 

Another space facility that may be provided in the distributed computing environment is a mechanism mat 
allows services and clients to find transient documents based upon a typing model such as XML. The mechanism 
may be a general-purpose, typed document lookup mechanism. In one embodiment, the lookup mechanism may be 
based upon XML. The lookup mechanism may allow clients and services to find documents in general, including 
services through service advertisements. 

In one embodiment, a space lookup and response message pair may be used to allow clients and services to 
find XML documents stored within a network transient document store (space). The space may be a document 
space used to store a variety of documents. In one embodiment, the documents are XML documents or non-XML 
documents encapsulated in XML. Spaces are further described elsewhere herein. The lookup messages may work 
on any kind of XML document stored in the space, including service advertisements and device driver 
advertisements. In one embodiment, a client (which may be another service) may use a discovery mechanism as 
described elsewhere to find one or more document spaces. Then, the client may use space lookup messages to 
locate documents stored in the space. 

The distributed computing environment may include a mechanism that allows services and clients to 
subscribe to and receive events about the publication of XML documents. Events may include the publication of 
and removal of XML documents to and from a transient XML document repository such as a space. In one 
embodiment, an event may be an XML document that refers to another XML document 
30 In one embodiment, a space event subscription and response message pair may be used to allow clients and 

services to subscribe for events regarding documents that are added to or removed from a space. In one 
embodiment, an event subscription may be leased using the leasing mechanisms described elsewhere herein. In one 
embodiment, a subscription may be cancelled when the lease is cancelled or expires. In one embodiment, renewing 
the lease to the subscription may renew a subscription. 
35 m one embodiment, an event subscription message may include an XML schema that may be used as a 

document fnatchmg mechanism Documents that match the schema may be covered by the subscription. In one 
embodiment, any document added to a space and that matches the XML schema may generate a space event 
message. 

A space facility may also be provided to which a client may register (or unregister) to obtain notification 
40 when something is added to or removed from the space. A space may contain transient content, reflecting services 
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that at added and removed from the space. A mechanism may be provided to notify a client when a service becomes 
available or becomes unavailable, for example; A client may register with an event service to obtain such 
notification. In one embodiment, a client may register to be notified when a service having a name matching a 
specified string or a schema matching a specified schema (or schema portion) is added or deleted from the space. 
5 Thus, a query to register with the space event notification facility may be me same as or similar to that of the service 
look up facility described above. 

When a client of a space subscribes to be notified when an XML documents) (e.g. service advertisement) 
is added or removed from the space, the client may obtain a lease on this subscription to notifications. The lease 
may allow the space service to know whether to continue sending notifications to a particular client For example, a 
10 lease to the notification faculty may expire after an amount of time if not renewed Note that a lease may not be 
required while a client has established an active session with a space. Once, a client has discontinued an active 
session with a space, the client may continue to receive event notifications according to its event subscriptions as 
long as hs corresponding leases remain active. Refer to the Leases section below. 

A client may subscribe to different types of events. Examples are a service advertisement being added or 
15 removed from a space, as described above. A client may also be notified when results from a service imtiated by the 
client (or by someone else) are put in a space. For example, the client and the service may mutually select a name 
for referring to the results of the service. The client may register with the space service to which the results are to be 
posted or advertised to receive an event when a result referenced by the selected name is added to the space. 

A space may generate different types of events to which a client may subscribe. As the composition of a 
20 space changes, events may be produced to those clients and services mat have subscribed for such events. In one 
embodiment, there may be two major space event categories, those mat pertain to the space (insertion and removal 
of advertisements), and those used mat indicate changes to an advertisement (adding, removing, changing an 
element or attribute). Which events are supported may be indicated in the XML message schema for the space. 

The following events are examples of events that may be produced by a space service to indicate a space or 
25 advertisement event 



Table! 



Event Name 


Type 


Meaning 


Advertisement 
Insertion Event 


AdvInsertEvent 


New advertisement has been inserted 
into a space 


Advertisement 
Removal Event 


AdvRemoveEvent 


Existing advertisement has been 
removed from a space 


Advertisement 
Element Insertion Event 


AdvElementlnsertEvent 


A new element has been added to an 
advertisement 


Advertisement 
Element Removal Event 


AdvElementRemoveEvent 


Existing element has been removed 
from an advertisement 


Advertisement 
Element Change Event 


AdvElementChangeEvent 


Existing element has been changed .in 
an advertisement 
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Advertisement Element 
Attribute Insertion Event 


AdvElementAttributelnsert 
Event 


A new attribute has been added to an 
element | 


Advertisement Element 
Attribute Removal Event 


AdvElementAttributeRemove 
Event 


Existing attribute has been removed 
from an element 


Advertisement Element 
Attribute Change Event 


AdvElementAttributeChange 
Event 


Existing attribute has been changed in 
an element 



Events may be typed. In some embodiments, the event facilities supported by spaces may allow for event 
listeners to take advantage ofj e.g., Java class (or XML types) hierarchies. For example, by listening for 
AdvElementEvent, the listener will receive events of type AdvElementEvent and all of its sub-classes (XML types). 
5 Thus, for this example all events pertaining to element changes (though not advertisement insertion and removal) are 
received. 

By way of further example, subscribing to or listening for a top-level event class or type, e.g. SpaceEvent, 
will result in the reception of all space events. Event class types may be distinguished via, for example, the Java 
instanceof operator or the XML typing system. 
10 An event may include a URI to the affected advertisement or element For example, AdvertisementEvent 

and. all its sub-classes may contain a reference (e.g. URI or URL) to the affected advertisement AdvElementEvent 
and its subclasses may be examined for the name of the affected element The previous element value (URI or 
URL), may be available, for example, from AdvElementRemoveEvent and AdvElementVahieChangeEvent 

A space event type hierarchy for one embodiment is illustrated in Figure 2 1 . Types may be defined in XML 
15 and usable in Java or any other suitable object-oriented language such as C++. 

A space may provide a facility for a client to instantiate a service advertised in the space. Service 
instantiation is me initialization done that allows a client to be able to run a service. On embodiment of service 
instantiation is illustrated in Figure 22. To instantiate a service, a client may first select one of the service 
advertisements published in the space, as indicated at 320. The client may use the various facilities, such as the look 
20 up facility, provided by the space to look up the various advertisements in the space. Then the client may request the 
space to instantiate the service, as indicated at 322. 

In one embodiment, service instantiation may include the following actions. After the client requests the 
space service to instantiate the selected service, as indicated at 322, the space service may men verify the client is 
allowed to instantiate the requested service, as indicated at 324. The space service may perform this verification by 
25 examining an authentication credential included in the client's message. The . authentication credential is the 
credential the client received when it established a session with the space service. The space service may. verify if 
the client is allowed to instantiate the requested service according to. the client's authentication credential and 
capabilities indicated for that client See the Authentication and Security section herein. 

Assuming the client is authorized, the space service may also obtain a lease on the service advertisement 
30 for the client with the lease request time specified by the client, as indicated at 326. Leases are further discussed 
below. The space service may then send a message to the client which includes the allocated lease and the service 
• advertisement of the service, as indicated at 328. in one embodiment, the client may run an authentication service 
specified in the service advertisement and obtain an authentication credential, as indicated at 330. See the 
Authentication and Security section herein for more information on an authentication service. Next, as indicated at 
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332, the client may construct a gate for the service (for example, using the authentication credential and the XML 
schema and service URI from the advertisement). Refer to the Gates section herein. The above described 
communication between the client and space service is performed using the XML messaging of the distributed 
computing environment The client may then run the service using the constructed gate and XML messaging. The 
5 service may similarly construct a service gate for XML message communication with the client 

To summarize, an example use of a space is discussed as follows; A client may access (e.g^ connect to) a 
space service. (A service may act as a client for the purpose of accessing or otherwise using a space.) The space 
service may store one or more service advertisements and/or other content in a space, and each of the service 
advertisements may include information which is usable to access and execute a corresponding service. The space 
10 service may include a schema which specifies one or more messages usable to invoke functions of the space service. 
For example, the schema may specify methods for reading advertisements from the space and publishing 
advertisements in the space. Tne schema and service advertisements may be expressed in an object representation 
language such as extensible Markup Language (XML). In accessing the space service, the client may send 
information such as an XML message (as specified in the schema) to the space service at an Internet address. In 
15 accessing the space service, the client may search the one or more service advertisements stored in the space. The 
client may select one of the service advertisements from the space. In one embodiment, the client may send an 
mstanriation request to me space after selecting th^ Aleasemaybe 
obtained for the desired service, and the lease and the selected service advertisement may be sent by the space 
service to the client The client may then construct a gate for access to the desired service. The desired service may 
20 be executed on behalf of the client 

Another facility provided by a space service may be the spawning or creation of an empty space. This 
space facility may allow a client (which may be a service to another client) to dynamically create a new space: In 
one embodiment, this space fecilhy may include an interlace for spawning an empty space with the same 
functionality (same XML schema or extended schema) as the space from which it is spawned. This fecility may be 
25 useful for generating (e.g. dynamically) spaces for results. For example, a client may spawn a space a request a 
service to place results or advertise results in the spawned space. The client may pass the spawned space URI 
and/or authentication credential to the service. Or a service may spawn a space for results and pass the spawned 
space URI and/or authentication credential to the client In some embodiments, once a space is spawned, it may be 
discovered just like other spaces using one or more of the space discovery mechanisms described herein. 
30 By using a mechanism in which a space may be created via an interface in another space (e.g. a space 

spawning facility), new spaces may be created efficiently. For example, in one embodment, storage for the 
spawned space may be allocated using the same facility used by the original space for storage. Also, a spawned 
space may share a common service fecility with its original (or parent) space. For example, a new URI may be 
assigned to me new space. Inone embodmient, the ne w URI may be a redirection to a common space fecm^ 
35 with the original space. Thus, a newly spawned space may use the same or some of the same service code as that of 
me original space. 

Space fecilities may also include security admmistration, for example, to update me various security 
policies of the space, and other adrnmistratiVe tacilities. For example, the number and age of advertisements maybe 
controlled and monitored by a root space service. Old acWertisements may be collected and (hsposed See, e. & ,the 
40 Leases section herein for when an advertisement may be considered old. The service implementing the space may 
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be under the control of an administrator. Hie adnunistrator may set policy in a service dependent manner. Space 
facilities may also include a facility to delete an empty space. 

Certain spaces may include facilities or services to further support the proliferation of certain clients, such 
as mobile clients. For example, services in spaces that a mobile client may discover, e.g. via the discovery protocol, 
may provide support for mobile clients, such as: 

• Assigning and administering temporary network addresses for the client 

• Proxying message passing for the client 

Providing search facilities for additional spaces. For example, a service may allow a 
client to specify keywords through a simple interface. The service then uses the keywords in 
conjunction with Web search engines to search for spaces on the Web, as further described 
herein. In other embodiments, a search service may constrain clients to searching only a few 
supported spaces within the distributed computing environment 
As mentioned earlier (see Figure 9 and accompmying text), spaces may provide a convenient mechanism 
for storing results from a service run by a client Using a space for results may allow a small client to receive in 
15 pieces the results of running a service. Some services may generate a large amount of results. By using a space to 
store the results from a service, clients that do not have the resources to receive the full results at once may soil use 
the service. Moreover, by using a space to store results, a service nmning on a fast busy server may be freed from 
interacting directly with a slow client when returning large results. Thus, the service may be freed sooner for use by 
other clients. 

20 A space may provide a convenient mechanism for accessing a result by different clients and/or at different 

times. For example, a client may not be able to use the entire result, but a user may want to access the rest of the 
result later using another client that can access it For example, the result could be stock quote information, showing 
the current price of a stock (accessible by a PDA), and showing a chart of stock prices (accessible by a laptop later). 
Also, using a space in the distributed computing environment for results may allow a client to feed the result of one 
25 service into another service, without the necessity of downloading the result first For example, in the case of the 
stock quote information above, the PDA could feed the chart into another service, which prints the chart, without the 
PDA having to download the chart itself Thus, a results space may provide a mechanism for a client to pass to 
another client or service without the client having to handle or receive me results. 

In different embodiments, the decision to use a space for results may be mandated by the service, mandated 
30 by the client, and/or requested by the client A service may suggest the use of a space for its results, e.g^, in its 
advertisement In one embodiment, either the client or the service may spawn a new space for results or use an 
existing space for results. See the description herein regarding spawning spaces. 

In one embodiment, the use of a space for results does not necessarily mean that the service must put all 
results in that space. There may be alternatives for any result a service generates. For example, part or all of the 
35 result may be sent in-line in a message to the client Alternatively, the result may be put in the space, and then a 
notification message may be sent to client, referencing the result (e.g. mchiding a URI to the result or to an 
advertisement for the result). Another option may be to put the result in the space, with notification via an event 
from the space. For example, the client and the service may agree to call the result some particular name, and then 
the client may register with die space (using a space facility such as described above) to receive an event when a 
40 result so named is added to the space. See the description above on event notification. 
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Thus, several different mechanisms may be employed within the distributed computing environment for a 
service to return results to a client The actual results may be returned to the client by value in an XML message, or 
results may be returned to the client by reference with the actual results (or advertisement for the actual results) put 
in a space and the client receiving a message referencing the results in the space. Moreover, results, or results 
advertisements, may be placed in a space and the client notified by event 

Another mechanism for handling results may be for the client to specify another service for the results to be 
fed to. For example, when a client runs a service mat will produce results, the client may instruct that service (e.g. 
through XML messaging) to send the results to another service for further processing. This may involve the client 
indicating the UR1 of an advertisement for the other service so that the result-producing service may generate a gate 
) to the other service in order to run the other service and pass it the results. In mis example, the result-producing 
service may be a client of the other service. In some embodiments, the client may send me schema or a pre- 
constructed gate to the result-producing service to access the service for further processing. An example of a service 
for further processing is a display service that may display the results for tire original client This display service 
may be on or associated with the same device as the client 
5 Result spaces and method gates may allow the distributed computing environment to provide a simple 

remote method invocation that is practical for thin clients with minimal memory footprints and minimal bandwidth, 
because it need not have the adverse side effects of huge program objects (along with needed classes) being returned 
(necessarily) across the network to the client as in conventional remote method invocation techniques. Instead, 
results may be returned to a result space, and only if desired (and if they can reside on the client) are the actual 

20 objects downloaded to the client 

The mechanism by which die distributed computing environment may provide for remote method 
invocation is as follows (refer also to the description of method gates in the Gates section herein). An object may be 
advertised (e.g. as a service or as part of a service) in a space. The advertisement includes a reference that contains 
the URI (e.g. URL) of the object, along with other access parameters, such as security credentials and XML schema. 
25 A client may have or may construct a client method gate for the object, which for every method of the object (or 
service) itself may have a wrapper method that takes the method parameters and creates a request XML message to 
invoke a method of Ihe object The XML message is sent to a service gate mat invokes me actual method on the 
service object When that method returns a result object, the service gate may post the result object in a results 
space, and may return a message to the client with a reference to the result object 
30 Thus,&ractirattomvokearemotememod^^ 

service), such as described above. In one embodiment, instantiation of an object may include the creation or 
spawning of a results space. In another embodiment, results space creation may be independent from the object 
instantiation. Instantiation may return the object URI to the client, and the client and service gates may be 
dynamically created when a client requests instantiation. In some embodiments, a results space may already exist 
35 and be advertised by the object (service). Some part or all of the gates may also have been pre-arastructed or 
reused 

Once a client has initiated an object, a local call of the appropriate client method gate will affect a remote 
call to the actual remote object, as described above. The remote method invocation approach of the distributed 
computing environment may be recursive, with object references returned to the client, instead of the objects itself, 
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when the client gate is called. Note that such returned objects may already be instantiated. In some embodiments, 
the client may make a decision to download an entire object itself rather than just remotely invoke it 

A method or service invoked as described above may generate a child gate that is associated with the 
results document The method may return a child gate (or the schema, URI and credentials for the client to construct 
5 a child gate) for the references instead of the references themselves. The client may then access the references 
through the child gate. The child gate may also be a method gate. 

As described above, this remote method invocation provided by the distributed computing environment 
allows the real result objects) to be stored in a service results space (which also may be created dynamically, by a 
servlet for example). The results space may be temporary. The results space may act as a query results cache. The 
[0 results cache may be patrolled by server software (garbage collector) that cieans-up old result areas. Distributed 
garbage collection may be employed, as result spaces may fill up until they are destroyed by a client mmcating it no 
longer needs the space, or by an administrator on a server setting appropriate limits. 

Turning now to Figure 23, an illustration of a default space 350 is provided. The distributed computing 
environment may provide at least one default space so clients can find an initial set of advertisements. A device may 
15 have a default space that exists locally, with a built-in pre-constructed gate. The services advertised in that default 
space may exist locally on that device, and they may provide system software that enables or facilitates the device's 
participation in the distributed computing environment 

The default space 350 may include one or more mechanisms 352 to locate external spaces, as shown in 
Figure 23. One service in the default space may run the space discovery protocol described above to find external 
20 spaces. Also, external spaces may be advertised in the default space. Additionally, a service (e.g. a search engine or 
a proxy service to a search engine) may be advertised in the default space that determines or finds external spaces. 
Each space may be analogous to a file system mount point Thus, the distributed computing environment may 
provide searchable, dynamic mount points to services. A default space may be a client's initial mount point to the 
distributed computing environment 
25 A default space or access to a default space may be built in to a device. Through the default space and 

local services that may exist on the device, a client execution environment for the distributed computing 
environment may be provided. A device's local services and default space service may have built-in pre-constructed 
gates. One of the built-in services listed in the default space may be a service to run the discovery protocol so that 
the client may locate additional (e.g. external) spaces. A default space may include a built-in service mat provides 
30 an execution environment for clients that allows the client user to browse spaces, select, and then instantiate 
services. Such a service may provide a simple user interface that allows a client to entire strings (e.g. keyword for 
space searches), view or browse result references (e.g. space listings, or service listings within a space), select items 
(e.g. to chose and instantiate a service), etc. 

Devices mat primarily provide a service may also include a default space and may include a built-in service 
35 in the default space that allows a service to manage advertising itself in various spaces. For example, a device, such 
as a printer, may have a built-in default service that finds (perhaps through the discovery protocol) a space on a local 
area network and adds an advertisement for the printer service to that space. This service may also maintain the 
printer service advertisement v/ithin the LAN space, for example, by renewing its lease or updating the printer's 
XML schema, etc 
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For some devices that provide a service, the overhead of raiding a space to advertise its service and 
maintain mat advertisement is undesirable. In one embodiment, rather than searching for and maintaining a space or 
spaces to publish service advertisements, services on some devices may transmit their advertisements in response to 
connection requests. For example, a printer device with a printer service that is available on a proximity basis may 
5 not maintain an advertisement in a space (on the device or external to the device). Instead, when another device 
establishes a connection with the printer device (for example, a user with a laptop running a client desires to print a 
document), the printer service may transmit the service advertisement to provide the XML service schema for 
connecting to and running the service that provides printing functionality on the printer device. Also, some devices 
may only maintain advertisements for their services in a certain vicinity or local network. Such a device may not 
10 desire to support or may not have access to transports for broader accessibility. 

One example of a service device in which H may be desirable for the device to avoid or limit maintaining 
service advertisements in a space is a device whose functionality is available on a proximity basis. Prarimfcy-based 
services may provide advertisements of their functionality upon request These advertisements may not be broadly 
accessible. For example, proximity-based services may be provided in a wireless communications system. The term 
15 "wireless" may refer to a communications, monitoring, or control system in which electromagnetic or acoustic 
waves cany a signal through atmospheric space rather than along a wire. In most wireless systems, radio frequency 
(RF) or infrared (ER.) waves are used. Typically, in proximity-based wireless systems, a device comprising a 
transceiver must be within range (proximity) of another device to establish and maintain a communications channel. 
A device may be a hub to connect other devices to a wireless Local Area Network (LAN). 
20 As mentioned, embodiments of the distributed computing environment may provide a mechanism using a 

lookup space mat allows clients to rendezvous with services. In a proximity computing environment, one 
embodiment of the distributed computing environment may provide a service discovery mechanism that clients may 
use to discover services without using lookup spaces as rendezvous points. An example of a proximity computing 
environment is an IrDA point-to-point communications environment In a proximity computing environment, the 
25 proximity mechanism may find the "physical" location of the service for the cUent For example, in an IrDA 
environment, the client device may be physically pointed at the device mcludmg me service(s) tnat flte cUent desires 
to use. 

The proximity service discovery mechanism may enable the client to direcuy look for service 
advertisements rather than sending a lookup request to a lookup space to look for service advertisements. Since the 
30 client device may have established a proximity connection to the service device, the client may directly request the 
desired service. For example, a PDA client device may establish a proximity connection to a printer device; the 
client may "know" to request a printer service connection on the printer device. 

In one embodiment, the client may send a proximh> service discovery message to the sem The 
message may include information that may specify a desired service on the service, device to which the client device 
35 has a proximity connection. In one embodiment, a service on the sendee device may respond to the proximity 
service discovery message, and may send to the client the service advertisement that the client may use to connect to 
the desired service. The proximity service discovery message may also include mformation that may be used to 
authenticate the client and to establish the client's capabilities on the service. Using the received service 
advertisement, the client may establish a gate to establish communication with the desired service. 
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Nevertheless, it may still be desirable to publish advertisements for services that do not desire to or cannot 
maintain their advertisements in a space mat is broadly accessible. In one embodiment of a distributed computing 
environment, a device that establishes a connection with a device that does not publish its service advertisement(s), 
such as a proximity-based device, may publish service advertisements received from the non-publishing device. For 
example, a device that establishes a connection with a proximity-based device and that has an alternate transport 
connections) may publish (or republish) service advertisements received from the proximity-based device in the 
alternate transport environment, thus allowing the proximity-based device service(s) to be used by other devices 
(through the (re)published service advertisements) which are outside fee normal proximity range of the device. 

The publishing device may locate a locally published service advertisement for the proximity-based device 
through a discovery and/or lookup service, of alternatively die service advertisement may not be published by the 
local service device, but instead may be sent to me publishing device by the local device upon the establishment of a 
connection, as described above. In one embodiment, the republished service advertisement may be made available 
as long as the device maintaining tie advertisement is connected to or.able to connect to the local device. For 
example, if the publishing device is disconnected from the local device (for example, moves out of proximity range 
of the device), die service advertisement may be made stale or removed. A lease mechanism may be provided to 
allow the space containing the advertisement to send lease renewal messages to the publishing device. The 
publishing device may verify its connection to the local device, thus allowing toe space to detect when die local 
device is no longer available. Rules for how toe service advertisements are republished may be provided by the 
local device or by an administrative policy for the local vicinity (e.g. proximity area) or local network. 
>0 Figure 24 illustrates an example of a device bridging proximity-based devices onto another transport 

mechanism to allow the services provided by the proximity-based devices to be accessed by devices outside the 
proximity range of toe devices, according to one embodiment. A publishing device 1404 may be connected to a 
network 1412, such as an Ethernet LAN or toe Internet, etc, and may establish and maintain proximity connections 
1414 with proximity devices 1400 and 1404. Proximity connections may be wireless connections or wired LAN 
25 connections, for example. Proximity devices 1400 and 1402 may each send a service advertisement to toe 
publishing device 1404 upon connection, or, alternatively, toe publishing device may locate the service 
. advertisements using a discovery and/or lookup service for toe proxhmty connections. The publislmig device 14M 
may then make the services provided by the proximity devices available to other devices 1408 and 1410 on the 
network 1412 by republishing toe service advertisements 1416 and 1418 in space 1406. Space 1406 may be stored 
30 on the publishing device or on other devices connected to toe LAN (inchidhig devices 1408 and 1410). 

Other devices on the LAN including devices 1408 and 1410 may then discover space 1406 and look up the 
republished service advertisements 1416 and 1418 for toe proximity-based devices, establish gates to commimieate 
to those services (device 1404 may act as a proxy or bridge) on the proximity-based devices 1400 and 1402 using 
toe XML message passing methods described previously, and send requests and receive results to toe proximity 
35 devices. Publishing device 1404 may act as a bridge between the network 14 12 and toe proximity connections 1414 
to toe proximity-based devices. . 



Leases may be used in the distributed computing environment to deal with partial failure, resource 
40 synchronization (scheduling), and to provide an orderly resource clean-up process. Leases may help the overall 
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distributed system manage independent clients and services that may come and go. The various resources that 
clients obtain from services (including space services) may be leased from those services. In general, hot every 
resource can or needs to be leased. In one embodiment, it is up to the implementation of each particular service to 
determine which of its resources need to be leased. In particular, resources used by a large amount of clients 
5 simultaneously may not need leasing or instead may require custom leasing protocols. This class of leasing may be 
left to the service provider. Custom protocols, such as those to implement transactions for example, may be built 
upon the base leasing scheme. In one embodiment, the base leasing model is a relative time-based model. . 

Services may issue leases to clients and provide operations on those leases. In one embodiment, all such 
lease functionality of a service is part of that service's XML schema. Thus, a client may use its gate (corresponding 
10 to the service and constructed for the service's XML schema) to perform lease operations. In one embodiment, all 
services mat issue leases provide the following lease operations (only allowed by the owner of the lease): (i) 
renewing a lease (parameters specified: lease" (e.g. lease ID, lease credential), new lease time requested), and (ii) 
canceling a lease (parameter specified: lease (e.g. lease ID, lease credential)). In one embodiment, all leases are 
granted for a particular amount of relative time (duration of lease) that may be negotiated. The requestor may 
15 specify a certain amount of time (e.g. in seconds), and the grantor may grant the lease for any amount up to mat 
time. In one embodiment, a -1 value may be used to specify an indefinite lease. 

In one embodiment, a service advertisement may include one or more leasing addresses. In one 
embodiment, the leasing addresses may be TJRIs. Standard leasing messages to renew and cancel service resource 
leases may be sent to a leasing URL An example lease URI: 
20 <leaser>service 1 ://resource 1 </leaser> 

An advertisement may also include various leasing messages as described above. Leasing messages may 
include messages to renew and cancel leases for resources of the service. In one embodiment, the messages may be 
comprised in an XML schema in the advertisement 

The leasing mechanism may provide a mechanism to detect service and client failure. Leases may also 
25 provide a me chanism to provide shared and exclusive resource access. In one embodiment, all service resources 
either have no lease (resource is not leased and therefore available), a shared lease (resource accessed by multiple 
clients), or an exclusive lease (resource is accessed by exactly one client at a time). In one embodiment, all 
resources begin in the no lease state. A no lease state signifies there is no current access to the underlying resource, 
and indicates that there is an interest in the resource remaining in existence and thus available for leasing. The 
30 leasing level may be increased from none to shared, none to exclusive, or shared to exclusive. Lease isolation levels 
may also be decreased from exclusive to shared, exclusive to none, and shared to none. In one embodiment, clients 
may voluntarily increase or decrease the lease isolation level, or may be requested by the service to do so. A 
response message from the service may indicate if the isolation level change was accepted. 

Request-response message pairs may be employed to claim, release, and renew a lease. Each message may 
35 be tagged using a reserved XML tag to indicate that the message is a leasing message. The distributed comrartmg 
environment doesn't necessarily define the complete composition of the message. In such an embodiment, service 
developers may append custom message content, as long as, the message is tagged as a leasing message. 

In one embodiment, clients that use leased resources may be expected to: (i) claim the resource as shared or 
exclusive, pi) release the resource claim (if requested or if finished with resource), and (in) respond to renewal 
40 messages (with another claim at same or different isolation level). Renewal messages may be sent (e.g. in regular 
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intervals) by services to detect client failure cases. The interval (at which the renewal message is sent) may be 
service specific. If a response to the renewal message isn't issued after a specific amount of time (e.g. based on a 
time noted in the service advertisement), a resource reclamation process may begin within the service, revoking the 
lease completely. In such an embodiment, renewal messages sent to clients should be handled in a timely fashion- 
5 Figure 25 illustrates the use of renewal messages bom between a client and an instantiated service and between a 
service provider and a space service. Note that both cases may be considered as the use of renewal messages 
between a client and a service, since a service provider may be a client to a space's advertisement service. 

Renewal messages may arrive in an "out of band" fashion that may be inconvenient for the client to handle. 
That is, the client cannot predict when a renewal message will be sent from the service. Out of band message 
10 handling may complicate the client's logic and increase its complexity. To solve this problem, an automatic lease 
renewal mechanism may be implemented to relieve the client of the responsibility of handling the out of band 
messages, and thus reduce client complexity. In the automatic lease renewal mechanism, each gate (message, 
method, and/or event gate) may receive renewal messages and automatically respond to them without help from the 
client The default response to a renewal request is to claim the lease at its current leveL Each message gate may 
15 contain a single, set-aside renewal response message that is automatically sent to the advertisement space service 
when the gate receives the renewal message. This "out of band" message is handled on behalf of the client, yielding 
a cleaner client programming modeL In one embodiment, the gate may allow clients to register lease event handlers 
to specify different isolation levels in the response message. 

The leasing mechanism may also provide a mechanism to detect stale advertisements. When a service 
20 publishes its advertisement in a space, that service obtains a lease on this publishing of its advertisement Each 
advertisement may contain a time by which the service promises to renew the advertisement In one embodiment, 
all time-out values are specified in seconds. If me service continues to renew its lease, the space is provided some 
assurance that the service advertised is stfll being offered The renewal time may be counted down towards zero by 
the space service. If the service does not renew its lease, the service may have failed, or it may no longer wish to, or 
25 be able to provide the service. When the lease is not renewed, the space service marks the service advertisement 
stale, so it does not make it available to clients. Services renew advertisements by sending a renewal message to the 
space. The space service receives these messages and resets the advertisement renewal time back to its initial value. 

In one embodiment, stale advertisements are not automatically deleted. Depending upon the policies of the 
space, it may choose to delete stale service advertisements that have expired for a reasonably long period of time. 
30 The deletion policy may be set by the space service. The space service may search for stale advertisements and 
either delete them or bring them to the attention of an adrrmiistrator, for example. 

A space service may use leases to manage the resources its facilities provide to clients (including other 
services) of the space. For example, when a client desires to use a service, the space service may request a lease for 
the client as part of service instantiation. Service instantiation may be performed to allow a client to run a service. 
35 To mstarroate a service, a client may first select one of the service advertisements published in a space. The client 
may use the various facilities provided by the space to look up advertisements in the space. Then the client may 
request the space to instantiate the service. The lease acquired during service instantiation is on use of the service 
advertisement (not the same as the lease on publishing of the service advertisement). It should be noted that the 
space service may allow multiple 'clients to have a lease on use of a service advertisement if the advertisement has an 
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indication it is shared Otherwise, the space service only allows one client at a time to have a lease on the service 
advertisement (exclusive). 

Another example of how a space service may uses leases to manage the resources its facilities provide to 
clients is when a client of the space registers to be notified when XML documents (e.g. service advertisements) are 
5 added or removed from a space. The registering client of the space may obtain a lease on this subscription to 
notifications. This lease enables the space service to know whether to continue sending notifications. Such a lease 
may not be necessary when a client has established an active session with the space. Also, note that when a client of 
a space (could be a service) establishes a session with the space, the client may obtain a lease on tie session. This 
allows the space to manage any resources associated with the session. 
10 In another embodiment, the distributed computing environment may employ a leasing mechanism that is 

net time-based The lease may be generated when an object is claimed for use. Instead of a time-based mechanism, 
the claim method may accept a callback that notifies the current leaseholder that some other party wishes access the 
same object (e.g. service). Thus, as an alternative embodiment to time-based leases, instead clients may make 
claims on space objects (e.g. services). When another client desires a lease that is incompatible with the current 
15 leaseholder's lease, the service may send a "callback message" to the client Upon receiving the callback message, 
the client (i.e client gate) may invoke a callback method to decide on a response to the callback message (keep the 
lease, cancel the lease, change the access level to shared, etc.). Once a response has been deteraiined, the client gate 
sends a response message to the service. This distributed mechanism for m anaging leases may be implemented 
using the XML message-passing layer. 
20 For a non-time-based lease embodiment, the distributed computing environment may provide lease support 

for several levels (or kinds) of access that allow a distributed algorithm to determine lease compatibility. Those 
levels may include: CO keep the object in the space (keepmSpace), (ii) read the object in the space (readShared), and 
(iii) read exclusively the object in the space (readExchisive). 

25 Authentication and Security 

The distributed computing environment provides for spontaneous and heterogeneous distributed systems 
based upon an asynchronous message passing model, where data and/or objects may be represented in a 
representation language such as XML. In the distributed cornpiiting environment, clients may connect to services 
throughout the Internet, for example. Hie distributed computing environment may enable large numbers of network 

30 devices to work together in a reliable, dynamic, and secure fashion. The distributed computing environment may 
define a protocol that substantially enables interoperabiUty between compliant software components (clients and 
services). 

In the context of the distributed (imputing environment, a device may be a networking transport 
addressable unit Clients and services may be implemented as Universal Resource Identifier (URI) addressable 
35 instances of software or firmware that run on devices. 

Internet space is inhabited by many points of content A URI is a method used to identity any of those 
points of content, whether it be a page of text, a video or sound clip, an image, software, firmware or other Internet 
content The most common form of URI is the Web page address, which is a particular form or subset of URI called 
a. Uniform Resource Locator (URL). A URI typically describes the mechanism used to access the resource, the 
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specific computer that the resource is housed in and the specific name of the resource (typically a file name) on the 
computer. 

Clients and services (both may be implemented on devices as software and/or firmware) may be connected 
over the Internet, a corporate intranet, a dynamic proximity network, within a single computer, or by other network 

5 connection models. The size and complexity of the devices supporting clients and services may range, for example, 
from a simple light switch to a complex, highly available server. Example devices include, but are not limited to: 
PDAs; cellular phones; notebook, laptop, and more powerful PCs; and more powerful computer systems, up to and 
including supercomputers. In some mbodiments, the distance, latency, and implementation of clients and services 
may be abstracted, with a common discovery and communication methodology, creating a "black box" effect This 

10 definition approach allows software implementation issues to be dealt with by the underlying platform, yielding a 
loosely coupled system that may be scaled to Internet proportions. 

The distributed computing environment may provide an Internet-centric progra mmin g model including 
WEB and XML content representation, dynamic device discovery, and secure device communication mat is 
accessible from a wide range of network devices. The distributed computing environment may include a network- 

15 programming model abstracted above the CPU level. The program m i n g model may include the following properties: 

• URI addresses 

• Strongly typed data called content (addressed with URIs) 

• Substantially unlimited amount of persistent content storage (e.g. stores), (containing XML and non-XML 
content, such as that identified by MIME types) 

20 • Substantially unlimited amount of transient content memory called spaces (containing XML content) 

• Descriptive XML metadata (data about data) content advertisements that may be stored in a space to notify 
interested clients. 

• a substantially unlimited number of instructions (embodied as messages) 

• Secure message endpoints (gates) addressed by URIs 
25 • Data flow support (event messages) to coordinate work flow between distributed software programs 

Services and clients may run as programs within the distributed computing environment Services may 
advertise their capabilities to clients wishing to use the service. Clients may or may not reside within the same 
network device, and that device's code execution environment may or may not support the Java platform. 

Using URIs to address content and message endpoints gives the distributed computing environment a 
30 powerful addressing scheme. The address may specify the location of the content or endpoint, and may specify the 
route (or transport protocol) to be used. Items addressed using URIs also may have an associated security 
credential. The security credential may be used to control what clients are allowed access to the item, as well as 
which operations authorized clients are allowed to perform on that hem. 

The high degree of access provided by the distributed computing environment may be controlled by 
35 appropriate authentication and security systems and methods. Authentication and security in the distributed 
confuting environment may include, but are not limited to: verifying the typing correctness of XML content in a 
message; securely identifying the sender to the receiver, a mechanism to check the integrity of messages sent from a 
client to a service and vice versa; and a mechanism of describing a service's set of accepted messages to a client and 
enforcing the message requirements on messages received at the service. The above listed security and 
40 authorization features may be leveraged in a single, atomic unit of code and data. The atomic unit of code and data 
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may be dynamically created. In one embodiment, once created, the atomic unit of code and data may represent a 
message endpoint (gate), and may not be altered as to the security and authorization policies implemented during 
creation. 

A gate may represent the authority to use some or all of a service's capabilities. Each capability may be 
5 expressed in terms of a message that may be sent to a service. Gates may also be used for Mure case detection 
when a client leases resources. 

Authentication and security may also include a mechanism for verifying that a client attempting to use a 
service is authorized to use the service; that the space from which the client receives the service advertisement from 
is authorized to provide the service advertisement; and/or that the service advertisement itself is authorized. 
10 Message passing may be implemented in a messaging layer as the means of communicating requests from 

clients to services and of the services responding with results to the clients. The messaging layer of the distributed 
computing environment may substantially guarantee mat valid XML messages are sent, and may provide 
mechanisms enabling a language-independent security model. In the messaging layer, a sending message endpoint 
may be linked to a receiving message endpoint The two associated message endpoints may provide a secure, 
1 5 atomic, bi-directional message channel suitable for request-response message passing between a client and a service. 

In embodiments of a distributed computing environment, an advertisement may be published in a space for 
a service. An advertisement may be an XML document that includes the XML schema and URI of the service. The 
service may also include a service ID token or credential in the advertisement, and may specify in the advertisement 
an authentication service to be used by both the client and the service. A client may then locate the service 
20 advertisement on the space, and use the advertisement to instantiate a message gate on the client The client may use 
the authentication service specified in the advertisement to obtain an authentication credential for sending in 
messages to the client In one embodiment, the client may pass the service ID token or credential from the service 
advertisement to the authentication service, and the authentication service may then use the service token or 
credential to generate the authenticarion credential for the client In one embodiment, the client may include a gate 
25 factory that receives the necessary information to create the message gate, and the gate factory may construct the 
message gate and communicate with the authentication service to obtain the authentication credential for the client 
A corresponding service message gate may be instantiated at the service. 

The client, at some point, sends a first message to the service. In one embodiment, the client message gate 
may embed the client's authenticarion credential constructed by the authentication service in the message. When the 
30 service receives the message, it may use the same authentication service to verify the authentication credential 
received in the message. By sharing the same authentication service, any of a variety of authentication protocols 
may be employed, with the details of generating the authentication credentials separated from the client and the 
service. Thus, a client may use different authentication credential protocols with different services. 

In one embodiment, the authentication service may determine the capabilities of the client (e.g. what the 
35 client is allowed to do on the service) upon first receiving the client authentication credential from the service. The 
capabilities of the client may be bound to the client's identity. Then, the client's message gate may embed the 
authentication credential in every message sent from the client to the service. The messages may be received by the 
service message gate and then checked by the authentication service to ensure that the message is from the client and 
that the message request is within the capabilities of the client In another embodiment, the service message gate 
40 may handle capability determination and message checking for capabilities without using the authentication service. 
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The client and service message gates may work together to provide a secure and reliable message channel. 
The gates may serve as secure message endpoints mat allow the client to run the service by sending and receiving 
secured, authorized XML messages to and from the service. 

Operations in the distributed computing environment may be embodied as XML messages sent between 
5 clients and services. The protocol used to connect clients with services, and to address content in spaces and stores, 
may be defined by the messages that can be sent between the clients and services. The use of messages to define a 
protocol may enable many different kinds of devices to participate in the protocol. Each device may be tree to 
implement the protocol in a manner best suited to its abilities and role. 

A service's capabilities may be expressed in terms of the messages the service accepts. A service's message 
10 set may be defined using an XML schema. An XML message schema may define each message format using XML 
typed tags. The tag usage rules may also be defined in the schema. The message schema may be a component of an 
XML advertisement along with the service's message endpoint (gate) used to receive messages. Extensions (more 
capabilities) may be added to services by adding messages to the XML message schema. 

In the distributed computing environment, authorized clients may be able to use all of a service's 
15 capabilities, or may be limited to using a subset of the service's capabilities. In one embodiment, once a set of 
capabilities has been given to a client, the client may not change that set without proper authorization. This model 
of capability definition may allow for services levels that run from a base set of capabilities to an extended set 

Service instantiation may be performed to allow a client to run a service. To instantiate a service, a client 
may first select one of the service advertisements published in a space. The client may use the various facilities 
20 provided by the space to look up advertisements in the space. Then the client may request the space to instantiate 
the service. Service instantiation may include, but is not limited to, the following steps: 

1. Client requests space service to instantiate a service. 

2. Space service verifies client is allowed to instantiate the service. 

3. Space service obtains a lease on the service advertisement for the client with the lease request 
25 time specified by the client Alternatively, the service advertisement may be provided to the 

client without using the leasing mechanism. 

4. Space service sends a message to the client that includes the lease allocated in steps 3, and die 
service advertisement of the service. 

5. Client runs the authentication service specified in the service advertisement, and obtains an 
30 authentication credentiaL 

6. Client constructs a client message gate for communicating with the service. 

In order to provide trust between clients and services in the distributed computing environment, a series of 
dynamically generated numbers (keys, or tokens) may be used as security or authentication credentials for clients. 
One or more credentials may be used to verify the right of a client to use a service and to verify messages between 
35 the client and the service. Each client and service may have a unique credentiaL 

The type of authentication credential needed to use a service may be returned to the client conducting a 
service search. In one embodiment, an authentication credential is an opaque object that must be presented each 
time a client uses a service. In one embodiment, the authentication credential may be presented by a message gate 
oh behalf of a client in every message sent to a service. No matter what kind of authentication credential is required 
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by a service, by using an authentication service external to the client and the service, the client and the service may 
not need to be aware of the authentication credential structure or of the authentication process. 

An authentication credential may also include a transport-specific ticket in addition to the service ticket 
When running a service, depending upon the networking transport specified in the service advertisement, the 
5 transport may provide a secure connection. In some cases, if the data link layer is already secure, it may not be 
necessary to use a secure transport over the already secure data link layer. 

The concept of an authentication credential is abstract enough to allow various levels of security based 
upon credential implementation. Levels of security may include, but are not limited to: 

1. None (no message security - credential is empty or no credential) 

10 Messages with empty credentials or no credentials may be sufficient when security is enforced 

by the physical connectrvity properties of the transport For instance, a smart light switch 
connected to just one light switch controller is secure because the switches are wired in a 
secure manner. 

2. Signed messages (digital signatures) 

15 Signed messages may include a digital signature that enables the service (receiving the 

message) to verify the origin (client) of the message. 

3. Encrypted messages (transport may handle mis) 

Encrypted messages add another level of security by scrambling the message contents so that 
another credential is required to unscramble it 
20 4. Capability messages (service functionality and user aware) 

This level of security may provide for security capabilities on a user-by-user basis (e.g. what 
the user is allowed to do), and may allow for fine-grained access control to services and 
individual service functions. 
Multiple levels of security zones may be used, due to the heavyweight implementation necessary to enforce 
25 the higher levels of security (capabilities & encryption). If the message transport supports (or helps support) these 
security levels, the support may be leveraged to provide security level bridge services that bridge one level of 
security to another. 

As mentioned above, services without any security model may accept empty authentication credentials. For 
services that do not restrict access, a gate may be built without an authentication credential or with an "empty" 
30 authentication credential- The gates for such services may not send an authentication credential with each message, 
or may send an empty credentiaL The authentication service is one example of a service that may not restrict access. 
Other services may require a user and password pair. 

Authenticating Service Access using Credentials 

35 In some embodiments, a mechanism for verifying that a client attempting to run a service is an authorized 

client, for verifying that the service advertisement received by the client is an authorized service advertisement, 
and/or for verifying that the space from which the client received the service advertisement is authorized may be 
based upon a public key/private key asymmetric cryptographic mechanism, In mis . mechanism, an authorized 
sending entity may embed a public key in a message and encrypt the message inchiding the public key with its 

40 private key. An entity receiving the encrypted message may decrypt the message using the public key and find the 
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same public key embedded in the decrypted message, and thus verify mat the message is from the authorized entity, 
since only that entity has the private key necessary to encrypt the message. Thus, an entity may issue a credential 
that is substantially unforgeable, and that other entities may decrypt (with the appropriate public key) to verify 
messages sent by the entity. 

5 Various key generation algorithms may be used in the distributed computing environment The 

composition of keys may be hidden from both clients and services; thus, the client and service may not care what 
key generation algorithm is used. 

A Kerberos ticket is one example of a security credential that may be used in the distributed computing 
environment Kerberos is a secure method for authenticating a request for a service in a computer network. 
10 Kerberos lets a user request an encrypted "ticket" from an authentication process that can men be used to request a 
particular service. The user's password does not have to pass through the network. 

Mechanisms may be provided by the distributed computing environment to substantially guarantee that 
messages sent between clients and services are not compromised. In one embodiment, a sender may embed a token 
containing information that may be used by the receiver to verify that the message has not been altered. There are 
15 several methods for generating the information to embed in the message. In one embodiment, a hash of the message 
may be computed and sent with the message. Hashing may include the transformation of a string of characters into a 
usually shorter fixed-length value or key that represents the original string. Upon receiving the message, the 
receiver may recompute the hash and check it against the sent hash. If the message has been altered, it is highly 
unlikely that the same hash will be generated. The sender may encrypt the hash and send the corresponding public 
20 key in the encrypted message to substantially ensure that the hash is not compromised. 

In other embodiments, an error detection scheme such as cyclic redundancy checking may be used. Cyclic 
redundancy checking is a method of checking for errors in data that is transmitted on a communications link. In an 
embodiment using cyclic redundancy checking, the sender applies an n-bit polynomial to the message and appends 
the resulting cyclic redundancy code (CRQ to the message. The receiver applies the same polynomial (which may 
25 also be passed in the message) to the message and compares its result with the result appended by the sender. If they 
agree, the message has been received successfully. If not, the sender may be notified to resend the message. 

Gate factories may also play a role in security, since a gate factory may be "trusted" code. Using a trusted 
gate factory to generate gates may help to ensure mat gates are trusted code, and that the code is correct with respect 
to the service advertisement Clients may be required to present a client ID token or credential to the gate factory as 
30 a means of authentication. Services may present a service ID token or credential to clients (e.g. through an 
advertisement) when a client wishes to create a gate. As discussed herein, a client and service token pair may be 
used to create a third credential that may be used to allow the client to send messages to the service. This third 
credential may be referred to as an authentication credential. An authentication credential may be created by an 
authentication service during the authentication process. In one embodiment, the service may use any authentication 
35 policy at its disposal In one embodiment, the authentication service administers the authentication policy on behalf 
of the service, and thus the service does not have to be aware of the particular authentication policy being used. 

Hie client may construct its gate using an authentication credential mat the client receives by r unning an 
authentication service specified in the service advertisement this may allow the constructed gate to send the 
authentication credential with each message to the service. When the service receives the first authentication 
40 credential in a first message from the client, the service may use the authentication service specified in the service 
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advertisement to authenticate the client, and thus may establish a binding of the authentication credential to the 
identity of the client 

As previously discussed, some results produced by a service may be advertised in a space and ultimately 
accessed using a results gate. The results gate may or may not contain the same security credential as the input gate 
5 used to generate the results. Because input to a service may be asynchronous from its output (the results), the results 
may have a different set of access rights associated with it For example, a payroll service may allow a different set 
of clients to initiate payroll than to read the payroll service's results (paychecks). Thus, a client may have to go 
through a separate authentication process to obtain access rights to the results, which may include receiving an 
authentication credential for the results from an authentication service specified in an advertisement for the results. 
10 Message gates may offload most security checks from services. Services may focus on providing capability 

and aumenticating clients. A principle of least privilege may be supported by giving clients access to only those 
capabilities that are requested (or assigned). 

Security checks may occur when a gate is created and/or when a gate is used (when messages are sent 
and/or received). When a client requests access to an advertised item (service), the process of gate creation may 
15 begin. During this process, the client gate factory may work with the service to mutually authenticate each other. 
The checks performed at gate creation time may be extensive, and may minimize the number of checks performed 
during gate usage. After the service has authenticated the client, the service may determine specific capabilities for 
the client (e.g. what the client is allowed to do on the service), and associate the capabilities with the client's 
authentication credential. These specific capabilities may specify what operations the client is allowed to perform 
20 on the service. Since the gates may ensure that every message contains the authentication credential, the service can 
then check each request when it is received against the capabilities of the authenticated client 

Gate creation checks may ensure that a client has permission to use some or all of the service capabilities 
designated by the XML message schema. In one embodiment, these checks may be implemented using access 
control lists (ACLs) in conjunction with an authentication service such as Kerberos. A challenge-response sequence 
25 (such as a password) may also be used to authenticate a client In some embodiments, a hardware-based physical 
identification method may be used to authenticate the client For example, the user may supply a physical 
identification such as a smart card for identification and authorization. Other mechanisms for authentication may be 
used in other embodiments. 

In one embodiment, whatever means is used to authenticate the client, the authentication may be invisible 
30 to both the client and service, the gate factory may be aware of which authentication service to use, and the 
authentication service handles the authentication mechanism and policies. Gate factories may be product and 
environment dependent, or may even be controlled by a configuration management system. In one embodiment, the 
degree and method of client isolation may be platform dependent, but is known to the gate factory. In some 
embodiments, a hardware-based physical identification method may be used to authenticate the client For example, 
35 the user may supply a physical identification such as a smart card for identification and authorization. Other 
mechanisms for authentication may be used in other embodiments. 

Message gates in the distributed computing environment are typically associated with a single client The 
gate factory may determine the means of association. The checks performed at message send time may ensure that 
the proper client is using the gate. In one embodiment, gates may be passed in messages, and may be cloned if a new 
40 client wishes to use the gate. The cloning process may perform a new set of creation checks. 
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Once a client of a space (the client may be another service) finds the advertisement of a space service, me 
client of the space may run the space service, as h would any other service. Running a space service may involve 
using an authentication mechanism. Running a space service may include, but is not limited to: 

1 . The client of the space may first rim an authentication service that may be specified in the 
5 service advertisement of the space service to obtain ah authentication credentiaL 

2. Hie client of the space may use the authentication credential, the XML schema of the space 
(from spaced service advertisement), and the URI of the space (from space's service 
advertisement) to construct a gate for the space. In one embodiment, the client may pass the 
information to a gate factory to construct the gate. 

10 . 3. The client of the space may run the space service by using the gate to send messages to the 

service. 

4. When the space service receives the first message from the client, with the authentication 
credential embedded, the space service may use the same authentication service used by the 
client to obtain the authentication credential to authenticate the client, thus establishing the 

15 . client's identity. 

5. The space service may men determine the client's capabilities (eg. what the client is 
allowed to do on the space service) and bind the capabilities to the authentication credentiaL 

As discussed in the Spaces section, a space's facilities may include an interface for spawning an empty 
space with substantially the same functionality (same XML schema) as the space from which it is spawned. The 
20 spawning facility may be useful, among other things, for dynamically generating spaces for results. When a 
requestor has spawned a space, only the requestor may be allowed to access the spawned space. For example, the 
spawned space may be for storing results from a service that the client needs to keep secured. This security may be 
ensured by: 

• Creating an initial root authentication credential, and initializing the authentication service of the spawned 
25 space, so that the authentication service only authenticates the root authentication credential, and so that it 

returns no other authentication credentials (no other clients of the spawned space allowed initially). 

• Initializing the security policies of the spawned space so mat the root identity associated with the root 
authentication credential has access to all facilities of the space, mcruding the security administration 
facilities. 

30 • Retu rning the root authentication credential and the service advertisement of the spawned space to the 

requestor of the spawned space. 

The requestor may build a gate to access the spawned space, since it is returned the authentication 
credential and the service advertisement of the spawned space. In one embodiment, only the requestor and clients or 
services mat the requestor passes the authentication credential and the spawned space's service advertisement may . 
35 access the spawned space. Such limiting of access to the spawned space may be useful when a client and service are 
using that spawned space to store results, for example, if the client and service desire to keep the results private. 

After running a service, the client may change the authentication policies of the spawned space using a 
security administration space facility, and other clients or services may then access the spawned space. In addition, 
the spawned space's service advertisement may be made available to other clients of the spawned space (the other 
40 clients may be services) using the discovery protocol or other means. 
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The message transport layer in a distributed computing environment may include mechanisms for 
protecting the security and integrity of communications among clients and services during transport This security 
may be referred to as "wire security" or "transport security 9 ' to distinguish it from the authentication security 
implemented by the messaging system including gates. Encryption of messages may be provided at the message 
transport layer of the distributed computing environment Services mat request an encrypted transport may do so by 
tagging the XML advertisement The gate factory may then create a gate (or gates) that uses a secure message 
transport such as those provided by Bluetooth and HTTPS. 

HTTPS (Secure Hypertext Transfer Protocol) is a Web protocol that encrypts and decrypts user page 
requests as well as the pages that are returned by the Web server. HTTPS may use a multi-bit key size (may vary 
from 40 to 128- bit or more) for a stream encryption algorithm (e.g. RC4), to provide an adequate degree of 
encryption for commercial exchange. HTTPS may be used as a transport in the distributed computing environment 
Bluetooth is an emerging peer-to-peer wireless communications standard. The Bluetooth key generation 
algorithms may be used in the distributed computing environment Bluetooth may support encryption keys. 
Encryption keys are transport dependent, while client, service, and combination keys may be transport independent 

Figure 26a - An authentication service providing an authentication credential to a client 

Figure 26a is a flow diagram illustrating an authentication service providing an authentication credential to 
a client according to one embodiment A client in the distributed computing environment may desire a service to 
perform one or more functions on behalf of the client In one embodiment, an authentication service may be 
provided for use by the client and the service when setting up a secure messaging channel. An authentication 
service may perform functions for the client and/or service including authenticating the client and/or service and 
negotiating the desired level of security and the set of messages that may be passed between the client and service. 
The authentication service may be a process that is executing within the distributed computing environment The 
authentication service may be executing on the same device as the service and/or the client, or alternatively the 
authentication service may be executing on a separate device such as an authentication server. In one embodiment, 
the authentication service may be an Internet-based service. The authentication service may have its own address, 
for example, a Universal Resource Identifier (URI), through which the client and/or service may communicate with 
the authentication service. In one embodiment, the address of the authentication service may be provided to the 
client in the service advertisement for the service. The client and service sharing an authentication service may help 
insure that a secure messaging channel may be established between the client and the service, as any of several 
security and authentication protocols may be used in the messaging channel. 

In one embodiment, a client may present a client identification token or credential to an authentication 
service. The client token or credential may be sufficiently unforgeable to be used as proof of the client's identity. 
The authentication service may then check the client identification token or credential, and issue to the client an 
authentication credential, that only the authentication service can create. The authentication credential that is 
returned to the client is then sent in every message by the client to the service. In one embodiment, the client 
message gate is created by a gate factory, which includes the authentication credential in the message gate, and thus 
the message gate includes the authentication credential in every message that it sends to the service on behalf of the 
" client When receiving a message, the service may then check the authentication credential Since only the 
authentication service can create the authentication credential, the service knows that the client did not forge the 
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authentication credential. In one embodiment, the service may pass the authentication credential to the same 
authentication service used by the client to ensure the authentication credential is valid, to verify that the client is an 
authorized client, and to find out the identity of the client 

All services, including space services and authentication services, may authenticate their clients. Once a 

5 service authenticates a client, the client may access the service. For example, in the case of a space service, a client 
may then obtain XML advertisements from the space. 

In one embodiment, a service may have a prearranged credential that all clients of the service are to use. In 
this embodiment, the authentication may provide the prearranged credential to a requesting client Any client 
presenting the prearranged credential to the service may be approved by the service. 

10 In step 1000, the client may request an authentication credential from the authentication service. In one 

embodiment, the client may search for and locate a service advertisement for the desired service. In one 
embodiment, the service advertisement may include an advertisement for the authentication service to be used to 
obtain an authentication credential to be used in accessing the service. In one embodiment, the service 
advertisement may include an address such as a URI for the authentication service. In one embodiment, the client 

15 may send information to the authentication service requesting the authentication credentiaL In one embodiment, the 
client may send information to a gate creation process, for example, a gate factory, and the gate creation process 
may access the authentication service to obtain the authentication credential. 

In step 1002, the authentication service may generate an authentication credential for the client Hie 
authentication credential may be a data element or data structure that may be embedded in messages in a messaging 

20 system and that may allow receivers of the messages to authenticate the sender of the message, to verify the message 
is from an authorized sender, and to verify that the message is a message the sender is allowed to send to the 
receiver. In one embodiment of a distributed computing environment, an authentication credential may be unique to 
the messaging channel set up between a particular client and a particular service. Step 1002 is further illustrated and 
described in Figure 26b. In step 1004 of Figure 26a, the authentication service may return the authentication 

25 credential to the client In one embodiment, the authentication credential may be returned directly to the client In 
one embodiment, the authentication credential may be returned to a gate creation process, for example, a gate 
factory, which may then use the authentication credential in generating a gate. 



70 



WO 01*6394 PCTAJS01/15134 

Figure 26b - An authentication service generating a n authentication credential 

Figure 26b is a flow diagram expanding on step 1002 of Figure 26a and fflustratmg an authentication 
service generating an authentication credential according to one embodiment In step 1002a, in one embodiment, 
the authentication service may obtain a client token and a service token. In another embodiment, the authentication 
service may obtain only a client token. In one embodiment, the client token may be a unique identifier for the client 
in the distributed computing environment In one embodiment, the service token may be a unique identifier for the 
service in the distributed computing environment For example, the public keys from a pubUc/private key 
encryption mechanism may be used as unique identifiers for the client and the service. In one embodiment, the 
client may receive the service token in the service advertisement, and the client may provide the client token and the 
service token to the authentication service. In another embodiment, the client may provide the client token and the 
service advertisement URI to the authentication service, and the authentication service may retrieve the service 
token from the service advertisement 

In step 1002b, the authentication service may verify the client and/or the service. In one embodiment, the 
authentication service may use the client token and the service token obtained in step 1002a to verify the client 
t5 and/or service. In another embodiment, only a client token was obtained in step 1002a, and thus only the client 
token is used to verify the client in step 1002b. In one embodiment, the client may have previously registered its 
client token with the aumentication service, and the authentication service may compare the received client token to 
the registered client token to verify the client as a valid client In one embodiment, the client may access the 
.aumentication service using a challenge/response mechanism such as a logon account with password and thus may 
20 be verified as a valid client In one embodiment, the service may have previously registered with the authentication 
service, and may have provided its service token to the aumentication service. The authentication service may then 
verify that the client is attempting to access a valid service by comparing the received service token to the previously 
registered service token. Other types of client andi service authentication may also be used. For example, the client 
may provide a digital signature or digital certificate that the authentication service may use to authenticate the client 
25 and/or to authenticate the service the client is trying to access. 

In step 1002c, the authentication service may generate an authentication credential. In one embodiment, 
the authentication credential may include an authentication token thai only the aumentication service can create. In 
one embodiment, the aumentication service may use the client token and the service token in generating the 
aumentication credential. In another embodiment, the authentication service may use just the client token to 
30 generate the aumentication credential. In yet another mbodiment, the authentication service may not use an 
obtained token in the generation of the aumentication credential, but may instead use an authentication credential 
generation algorithm to generate a substantially unforgeable authentication credential. In one emr^odiment, the 
aumentication service may combine the service token and client token to create a unique aumentication credential. 
For example, the service token and client token may be 64-bit values, and the two tokens may be combined to 
35 generate a 128-bit aumentication credentiaL Other embodiments may use other methods to generate an 
authentication credentiaL 
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Bridging Devices to the Distributed N etwork Environment 

There may be devices, external to the distributed computing environment, which do not support the 
message passing model implemented by flic distributed computing environment These devices may provide 
services mat may be useful to clients in the distributed computing environment. The distributed computing 
environment may include a mechanism to bridge such external devices to the distributed computing environment so 
that clients in the distributed confuting environment may access the services offered on such devices. The 
distributed computing environment may also leverage existing device discovery protocols for discovering such 
external devices for use in the distributed computing environment 

Many technologies define discovery protocols for publishing and monitoring a networks device 
composition. These technologies include, but are not limited to: Jini, SLP, Bluetooth, and TJPnP. Furthermore, 
marry I/O buses such as LonWorks, USB and 1394 also support dynamic discovery protocols. The distributed 
computing environment may leverage device discovery technologies by wrapping their implementations in an APL 
Leveraging other device discovery protocols and providing a method to bridge to other discovery protocols may 
allow the distributed computing environment to discover devices or services on a wide variety of network and I/O 
buses. Device discovery in the distributed computing environment may thus be applicable to a wide range of 
devices including small devices such as PDAs, even if they do not participate directly in the distributed computing 
environment Discovery proton 

A bridging mechanism may be provided for "wrapping" one or more specific device discovery protocols, 
such as Bluetooth's, in a messaging API for the distributed computing environment Wrapping may include framing 
20 the device discovery protocol with code and/or data (the API) so that the protocol can be run by clients and/or 
services in the distributed confuting environment that would not otherwise be able to run it When run, the 
bridging mechanism may allow for a discovery agent that discovers devices by a specific device discovery protocol 
to publish services for those devices in a space in the distributed computing environment The services present an 
XML message schema intertace to clients in the distributed network environment, and are capable of operating the 
25 various devices discovered by the specific device discovery protocol. Thus, service advertisements may be 
published for the services that operate the various devices discovered by the underlying wrapped device discovery 
protocols. The advertised services thus bridge devices (or services) external to the distributed network environment 
to clients on the distributed network environment 

Figure 27 illustrates one embodiment of a distributed conmuting environment with a space 1200. One or 
30 more discovery agents 1204 may participate in an external discovery protocol and bridge to the distnTrated 
computing environment through bridging mechanism 1202. When the wrapped device discovery protocols are run, 
discovery agents 1204 through bridging mechanism 1202 may publish service advertisements 1206a-1206c in space 
1200, wherein each one of advertisements 1206a-1206c corresponds to a device or service discovered by one of 
discovery protocols 1204 outside the distributed computing environment Clients may then access the external 
35 • devices using the service advertisements 1206a-1206c in space 1200 to instantiate services on one of the agents 
1204 mat operates the corresponding external device or service. 

Thus, clients of the distributed computing environment may use discovery agents wrapping device 
. discovery protocols to find devices. A service acting as a bridge to these devices may be published in a space and 
advertised, so clients of the distributed computing environment may access the services provided by the external 
40 devices. The advertised service is a service wit^ 
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device outside the distributed computing environment via another protocol or environment, thus bridging the outside 
device/service to the distributed computing environment. A client within the distributed computing environment 
"sees" only the advertised service within the distributed computing environment and may not even be aware of the 
outside device/service. 

5 In one embodiment, the distributed computing environment may provide a version of a space discovery 

message protocol, such as the discovery protocol described in the Spaces section, that may be mapped to an 
underlying external device discovery protocol, including the wrapped device discovery protocols described above. 
The mapped discovery protocol may register itself .or be registered with a space, e.g. a default space, by placing an 
advertisement in that space. For each advertised discovery protocol, a subsequent results space to hold the results of 
10 the discovery protocol may be provided. 

Figure 28 illustrates an example of the space discovery protocol mapped to a Bluetooth discovery service 
1220 according to one embodiment The Bluetooth discovery service 1220 may first register 1230 with the 
distributed computing environment The Bluetooth discovery service 1220 may be wrapped in a bridging API, and 
an advertisement 1225 for the discovery service 1220 may be added 1232 in space 1224. A client or service may 
15 locate the discovery service advertisement 1225 on space 1224. When the discovery service 1220 is executed 
(utilizing the API wrapper as a bridge between the discovery protocol 1220 and the distributed computing 
environment 1222), a new space 1226 may be created 1234 to store the results of the discovery process. The 
discovery service 1220 may store the results (again through the API wrapper) to discovery results space 1226 as one 
or more advertisements 1227. Alternatively, results of executing discovery service 1220 may be stored to space 
20 1224 or other pre-existing spaces in the distributed computing environment A similar method as illustrated in 
Figure 28 may be used to discover devices and other services using other underlying discovery protocols. 

As mentioned above, there may be devices, external to the distributed network environment, which do not 
support the message passing model implemented by the distributed network environment These devices may have 
clients mat may want to use services provided in the distributed computing environment The distributed computing 
25 environment may provide a mechanism to bridge the external clients or client devices to the distributed computing 
environment so that the clients on the external devices may access services in the distributed computing 
environment 

Agents may be provided that serve as clients in the distributed computing environment to bridge external 
clients to the distributed computing environment, allowing the external clients to access services published in the 

30 distributed c^puting environment In one embodiment, an agent may have an XML-enabied back end capable of 
communicating with services in the distributed coinputmg environment using the message passing model, and a 
proprietary protocol (e.g. a protocol supported by the external device) on the front end to interlace to the external 
device, and thus to the external client Thus, a client external to the distributed computing environment may locate 
and access services in the distributed computing environment through the bridging agent, and may send requests to 

35 the services and receive responses from the services, including results data. For example, an external client may use 
the bridging agent to run space discovery in the distributed computing environment, lookup advertised services, and 
invoke services in the distributed computing environment 

In one embodiment, the distributed computing environment may provide a bridging mechanism for 
accessing Jini services from a distributed computing environment client Since Jini services may require Remote 

40 Method Invocation (RMQ, and since clients in the distributed computing environment may communicate to services 
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using messages such as XML messages, a protocol bridging mechanism may be provided to enable the access of a 
Jini Service by a distributed computing environment client In one embodiment, a connector mechanism may be 
defined that enables the dynamic advertisement of Jini services in distributed computing environment spaces, and 
mat also may enable the accessing of a Jini service proxy from clients in the distributed computing environment In 
5 one embodiment, there may be Jini services that may not be bridged to the distributed computing environment 

In one embodiment, an agent may be provided as a service in the distributed computing environment that 
bridges the Jini RMI protocol used by Jini services to XML messaging used by distributed computing environment 
clients. When the agent is started, the agent may perform a lookup on the Jini spaces for Jini services that have a set 
of attributes. For every registered Jini service, the agent may generate an XML advertisement that may correspond 
10 to the service and may register the advertisement in a space in the distributed computing environment In one 
embodiment, an agent may register for event notification in the Jini Lookup service, and thus may be informed when 
a new Jini service is registered- When informed of a new Jini service, the agent may perform a lookup in Jini spaces 
to locate newly advertised Jini services and to update the distributed computing environment space with new XML 
advertisements for the new services. In one embodiment, when a Jini service is removed, the agent may receive an 
15 event notifying of the removal of the Jini service. The agent may then remove the XML advertisement for the 
service from the space. 

In one embodiment, to invoke a Jini service via an XML advertisement in a distributed computing 
environment space, a client may look up the service advertisement in the space and may send valid messages to the 
agent to access the service. The agent may invoke the proxy service corresponding to the Jini service by invoking 
20 the corresponding method through an RMI call to a service proxy. If the proxy is not instantiated, the agent may 
download the proxy code and instantiate a new instance of the proxy object In one environment, every client 
connection may have a different proxy-instance. The incoming message from the client may be converted by the 
agent into a method call for the proxy. The result from the method call may be returned to the client as an outgoing 
message. 

25 In one embodiment, only simple Java types may be used as arguments to an RMI method. If complex Java 

types are required, then one or more data advertisements may be passed as arguments to the call, where the data 
advertisements may indicate the location and access method of data for the complex Java types. In one 
embodiment, the agent may perform initial conversion from XML messages to an RMI method call invocation 
dynamically. Since, the agent knows the service interface, it may generate the corresponding set of messages that are 

30 advertised tome client 

Figure 29 illustrates bridging a client 1250 external to the distributed computing environment to a space 
1254 in the distributed computing environment Bridging agent 1252 may serve as the go-between between client 
1250 and space 1254. Bridging agent 1252 may communicate with client 1250 in a communications protocol 
understandable by the client 1250. Bridging agent 1252 may map the client's communications protocol into the 

3 5 XML messaging protocol necessary to communicate with space 1254 perform the facilities provided by space 1254. 
Bridging agent 1252, at client 1250' s request, may locate and run services on space 1254. For example, client 1250 
may request a list of all services of a particular type from space 1254. Bridging agent 1252 may locate service 
advertisements 1256a-c and return the results to client 1250. Alternatively, the results may be posted in a results 
space, and the location of the results may be returned to the client 1250. Client 1250 may then choose to execute 

40 service advertisement 1256a, and may send a message (in the client 1250's communications protocol) to bridging 
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agent 1252. Bridging agent 1252 may then send the XML request message(s) necessary to execute the service 
represented by service advertisement 1256a, and may return the results of the service to client 1250. Methods of 
handling the results of the service other than directly returning the results to the client 1250 may be used as 
described above in the section titled Spaces. Bridging agent 1252 thus may act as a service of the external client 
5 1250 (via the external client's protocol) and as a client within the distributed computing environment to bridge a 
service within the distributed computing environment to the external client 

Sometimes, even within the distributed computing environment, clients and services cannot directly 
communicate with each other, only to a common space. In mis case, the space service will automatically create a 
service proxy that bridges client to service. The proxy's main job is to route messages between client and service 
10 through the space. The service proxy may be created dynamically. The creation mechanism may be dependent 
upon space implementation. Refer to Figure 30 for an illustration of a proxy mechanism. A client 554 and a service 
556 may not be able to communicate directly within the distributed computing environment, e.g^ because they 
support different transport or network protocols. However, they both may be able to communicate with a space 552 
mat supports both protocols. The space service may create a proxy 550 to bridge the client 554 to the service 556. 
15 A common form of proxy is a browser proxy. A browser proxy (most commonly implemented as a servlet) may 
translate conventional Web page requests into messages. Refer also to the description of space search services (and 
proxies therefore) in the Spaces section herein. 

The distributed computing environment may provide a mechanism for bridging clients in the distributed 
computing environment to enterprise services. In one embodiment of a distributed computing environment, a 
20 method for bridging clients to enterprise services may include a client within the distributed computing environment, 
a bridge service within the distributed computing environment, and an enterprise service within the enterprise 
environment Hie distributed computing environment bridge service serves as a bridge service between the client 
and the enterprise service. An enterprise may be a corporation, small business, non-profit institution, government 
entity, or other kind of organization. An enterprise may utilize an enterprise computing environment for conducting 
25 a portion of its business. The enterprise computing environment may include various enterprise services. Clients in 
the distributed computing environment may desire to use services in the enterprise computing environment An 
enterprise service may be based on a number of architectures, such as three tiered client/server architectures. An 
example of an architecture mat may be used to implement an enterprise service is Enterprise JavaBeans. Enterprise 
JavaBeans (EJB) is an architecture for setting up program components, written in the Java programming language, 
30 that run in the server parts of a enterprise environment using a client/server model. In object-oriented programming 
and distributed object technology, a component is a reusable program building block that may be combined with 
other components in the same or other computers in a distributed network to form an application. EJB is built on the 
JavaBeans technology for distributing program components (Beans) to clients in a network. To deploy an EJB Bean 
or component, it must be part of a specific application, which is called a container. In Enterprise JavaBeans, there 
35 are two types of beans: session beans and entity beans. An entity bean is described as one that, unlike a session bean, 
has persistence and can retain its original behavior or state. Using EJB, programs may be deployed across 
substantially all major operating systems. EJB's program components are generally known as servlets (little server 
programs). The application or container that runs the servlets is sometimes called an application server. 

The bridge service interacts with the client via XML message passing to gather input parameters necessary 
40 to make requests to the enterprise service outside of the distributed network environment For example, the bridge 
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service may be looked up and instantiated by the client just as any other service in fee distributed computing 
environment The bridge service then may interact wife the enterprise service to run fee enterprise service. This 
interaction may use an interprocess communications architecture that fee enterprise service can understand. As an 
example, if an enterprise service is implemented wife Enterprise JavaBeans (EJB), a bridge service may 

5 communicate wife the enterprise service using EJB. The bridge service may then receive results from fee enterprise 
service and may return fee results directly to fee client (in XML messages) or may place fee results in a space in the 
distributed network environment (elg. a results space). To fee client, fee bridge service appears to be the only 
service (the enterprise service is hidden to fee client), so fee client does not have to support fee architecture of the 
enterprise service. Multiple distributed network environment clients may use the same bridge service (each using a 

10 unique gate pair) to interact with fee enterprise service. 

The bridge service or other agent may publish an advertisement for fee bridge service (and feus for fee 
enterprise service) in a space in fee distributed computing environment For example, a bridge service or other 
bridge agent may use Java Reflection to examine Beans for services in an enterprise system implemented wife EJB, 
and then create service advertisements for bridge services to fee Beans and publish those advertisements in spaces in 

15 the distributed computing environment. Reflection is a method for Java code to discover information about fee 
fields, methods and constructors of classes, and to use reflected fields, methods, and constructors to operate on their 
imderiying counterparts on objects, within security restrictions. The Reflection API accommodates applications that 
need access to either the public members of a target object or the members declared by a given class: Once fee 
bridge services are advertised, clients may access the bridge services (and feus the corresponding enterprise 

20 services) similarly to any other advertised services in fee distributed network mviroim^ 
architecture of fee enterprise service providing fee services. 

Client Displays 

There are several methods in which results from a service run by a client may be displayed in a distributed 
25 computing environment Devices feat may display results may include, but are not limited to: CRTs on computers; 
LCDs on laptops, notebooks displays, etc; printers; speakers; and any other device capable of displaying results of 
the service in visual, audio, or other perceptible format The methods for displaying results may include, but are not 
limited to: 

• The service may return results to a client directly or by reference, and fee client may handle the 
30 display of fee results. 

• The service may return results to a client directly or by reference, and fee client may pass the 
results to a display service directly or by reference, and fee display service may display fee results. 

• The service may directly handle fee displaying of fee results. 

• The service may pass fee results to a display service directly or by reference, and fee display 
35 service may display fee results. 

In fee last method of displaying results, fee client may specify fee display service. For example, there may 
be a display service on or associated wife the device on which fee client resides feat the client wishes to use to 
- display the results of fee service. When fee client runs fee service, the client may send a message to fee service 
specifying the service advertisement of the client's display service. The service may then build a gate that allows it 
40 to send messages to fee client's display service. Thus, when displaying results, the service invoked by fee client 
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becomes a client of the client's display service and sends its results (directly or by reference) for display to that 
display service. More detail on the client-service relationship, gates, and messaging is included in other sections of 
this document 

Conventional application models are typically based on predetermined, largely static user interface and/or 
5 data characteristics. Changes to conventional applications may require code modification and recompilatiorL The 
mechanisms described for advertising services and for specifying XML message schemas for communicating with 
services in the distributed computing environment may be used to provide a mechanism for applications (clients, 
services, etc) to describe dynamic display objects. Using the dynamic display objects, application behavior may be 
altered without having to download new code, recompile, or re-link the application. Display schemas may be 
10 provided for displaying the same results in different formats, for extract 
for displaying the results on different display devices. 

Figure 31 illustrates one embodiment of a client 1300 with associated display 1302 and display service 
1304 according to one embodiment An advertisement 1306 for display service 1304 may be registered on space 
1308. An advertisement 1312 for service 1310 may be registered on space 1314 by service 1310. Alternatively, 
15 service advertisement 1312 and display service advertisement 1306 may be registered on the same space. Client 
1300 may search for and discover (1320) service advertisement 1312 on space 1314, and may then set up a gate to 
send requests to (and receive results or responses from) service 1310. In one embodiment, the messages may be in 
the form of XML messages specified in an XML schema received as part of advertisement 1312. Client 1300 may 
send one or more messages (1322) to service 1310. The one or more messages may include messages for running 
20 service 1310 and for mstructing service 1310 to send results to display service 1304 for display, and may specify the 
location of display service advertisement 1306. The advertisement location may be specified as a Uniform Resource 
Identifier (URI). 

The messages from client 1300 to service 1310 may instruct service 1310 to perform one or more 
operations that produce displayable results. Service 1310 may retrieve display service advertisement 1306 from 

25 space 1308 based upon the location information received from client 1300. The service advertisement may include 
the XML message schema and other information necessary to interface with display service 1304. Service 1310 
may then set up a gate to send requests to (and receive results from) display service 1304. In other embodiments, 
messages from client 1300 to service 13 10 may include the XML schema and other information needed for service 
1310 to construct a gate to display service 1304, or may include a pre-constructed gate to display service 1304. 

30 During, or after completing, operations requested by client 1300, service 1310 may send the results of the 

operations to display service 1304 in the manner specified by the schema for display service 1304 (e.g. encapsulated 
in XML messages specified in the XML message schema or by reference as parameters for the display service). In 
this regard, service 1310may a chent of display service 1304. Display service 1304 may men format and display 
the results received from or indicated by service 1310 on display 1302 for the client 

35 In some embodiments, service 1310 may post the results of operations to a space such as a results space 

(not shown). Service 1310 may then send a message to display service 1304 including a reference to the stored 
results of the operations. In one embodiment, the reference may be in the form of a URL The display service 1304 
may then retrieve the results from the space and display the results on display 1302. 

Conventional application models are typically based on predetennined, largely static user interface and/or 

40 data characteristics. Changes to conventional applications may require code modification and recompilation. The 
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mechanisms described for advertising services and for specifying XML message schemas for communicating with 
services in the distributed computing environment may be used to provide a mechanism for applications (clients, 
services, etc) to describe dynamic display objects. Using the dynamic display objects, application behavior may be 
altered without having to download new code, recompile, or re-link the application. 
5 The dynamic display objects may be described in XML schemas. These schemas may be advertised in 

spaces. These schemas may be referred to as display schemas or presentation schemas. An application (or other 
services acting on behalf of the application) may then access the schemas from the service advertisements to display 
data based upon formatting, data type, and other information stored in the schemas. 

The following is an example of a schema containing dynamic display objects: 

10 

<element name="delivery H type= M Space:shipto" nimOccurs="0" t> 
<type name="TextField"> 
<element name=" Address" type="string"/> 
<element name="Crty" type= M string7> 
15 <element name="State" rype= n string"£> 



</type> 

20 

The above schema may be changed to the following without requiring an application recompile: 

<element name="delivery" rype="Space:shipto" ininOccurs= n 0" f> 
<type name^TextField^ 
25 <element name^'Name" type= n string n /> 

<element name=" Address" type= M string n A> 

<element name="City" rype="string7> 

<elementname="State n type="string ,, > 

30 ... 
</type> 

Figures 32A and 32B illustrate examples of using schemas of dynamic display objects according to one 
35 embodiment In Figure 32A, application 1320 (may be a client, a service, or other application), has been 
implemented with presentation schema advertisement 1324 stored in space 1326. A presentation schema 
advertisement may include elements describing the data types, formatting specifications, fonts, locations, colors, and 
any other information used for displaying data for the application on display 1322. There may be multiple 
presentation schema advertisements for application 1320. For example, mere may be one schema for each display 
40 page in a series of d^lay pages (for example, Web pages on a Website). 
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In one embodiment, application 1320 may invoke a discovery and/or lookup service to locate presentation 
schema advertisements. The discovery and/or lookup service may return an XML document listing one or more 
advertisements, and URls to each of the schemas describing a particular display format, etc. Application 1320 may 
then select a presentation schema or schemas from the XML document Apphcarion 1320 may then parse the 
5 schema, breaking out the elements of the schema into user interface components. The components men may be used 
to locate, format, and display results data on the appropriate display: The result data may be from running a service 
or from a results space, for example. Thus, as opposed to having a static or piedeterrmned display, the appUcation 
. 1320 is configured to display results according to a presentation schema that may be dynamically changed without 
requiring a rebuild of the application. 
10 Presentation schemas may be provided for displaying the same results in different formats, for extracting 

portions of the results for display, and for displaying the results on different display devices. 

In one embodiment, one or more presentation schema advertisements may be stored in one or more spaces 
in a distributed computing environment As copies of an apphcation are invoked on one or more devices, each copy 
of the application may run a search for services to discover advertisements for the presentation schemas used by the 
15 appUcations. Thus, a central, persistent store of the display information may be kept for multiple instances of the 
application or for other appUcations. The display information may be modified in the central location without 
reqiiiring the recompilation and/or reinstallation of the applications. 

In Figure 32B, client 1328 may locate a service advertisement for service 1330 on a space. When invoking 
service 1330, client 1328 may pass a location of presentation schema advertisement 1324 on space 1326 to service 
20 1330. When service 1330 is ready to provide results to client 1328, it may display the results on display 1322 
(which may be coupled to the device on which client 1328 is running) using the display information from the 
presentation schema provided by presentation schema advertisement 1324. To change the way the results are 
displayed, the XML messages in the presentation schema advertisement 1324 may be modified, or a different 
presentation schema may be selected, without requiring changes at the client 1328 or service 1330. Service 1330 

25 may be a display service. 

A client, appUcation or service may provide a plurality of display schemas for displaying results of various 
operations provided by one or more services. Alternatively, a display schema may include information for 
displaying a variety of results for one or more clients. Thus, client 1328 may use one display schema or a ptarality of 
. display schemas. Two or more display schemas may be provided for formatting and displaying the same results with 
30 different formats, or on different displays. For example, one display schema for a set of results may be provided for 
displaying results on a display screen, and another for printing the results. Also, copies of the same application, 
client or service may run on devices with different display capabilities, so two or more display schemas may be 
provided for supporting the display requirements of the different devices. 

35. String Management 

String handling in conventional systems is generally not very efficient, especially for variable sized strings, 
and may be wasteful of memory space, e.g. as the string is copied and/or moved in memory. This inefficiency in 

suuighanoTmgmayber^ ' lb ? 
amount of memory, particularly stack space and space for dynamic aUocation, may be linxrted in small footprint 
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systems. Thus, a more efficient method of handling strings in programs executing within small footprint systems 
such as embedded systems is desirable. 

Figure 33 A illustrates a typical string representation in the C programming language. In C, a string may be 
represented by a character pointer 1450 (stringl) containing a memory location (address) of the first character of a 
string 1452. Other characters follow the first character in the string 1452, and are typically stored in consecutive 
addressable byte locations in memory. Characters in C strings are typically 8-bit The characters m C strings may 
be any ASCII character. A C string must be tenninated by a NULL character. NULL is platform defined as one of 
the 256 possible 8-bh values, but is typically the binary value ObOOOOOOOO. The string 1452 occupies 13 bytes (12 



10 



An example of a string operation in C is the strienO function, typically provided with standard C library 
implernentatioas. The strienO function takes a string pointer as input and returns die length (in bytes) of the string, 
not including the terminating character. For example, passing the character pointer 1450 to the strlenQ function 
would return the length 12. The strienO function may be implemented by «Valking" the string until the terminating 
character is located, counting each character. 
15 String copying in C is typically handled by a strcpyO or a stmcpyQ C library functions, which are 



as: 

char *strepy(char *dest, const char *src); 
char *stmcpy(char *dest, const char *src, size_t n); . 
The strcpyO function copies the string pointed to by the character pointer sre (including the terminating character) to 
20 the string pointed to by character pointer dest . The strings may not overlap, and the destination string dest must be 
large enough to receive the copy. 

The stmcpyO function is similar, except that not more than n bytes of sre are copied. Thus, if mere is no 
laminating character among the first n bytes of sre, the result will not be terminated If desired, an instruction may 
be placed in the code following a stmcpyO to add a tennination character to the end of the dest string In the case 
25 where the length of sre is less than that of n, the remainder of dest wfll be padded with nulls. The strcpyO and 
stmcpyO functions return a pointer to the destination string dest . 

Figure 33B illustrates an example, of the results of the stmcpyO function on string 1452, when stmcpyO is 
called with the following parameters: 

30 stracpy(string2, stringl+3, 5); 

where string2 is character pointer 1454 pointing to the first byte after the terminating character of string 1452, 
stringl+3 is character pointer 1450 incremented by 3 bytes, and 5 is the numba- of characters (bytes) to bocop^ 
fem me source location stringl+3 to strmg2.Afto 
35 strict n^ be set to me terminating^ 

prior to the copy). Thus, the two strings now occupy (13 + 6) = 19 bytes of memory. If the strcpyO &nction was 
applied with character pointer 1450 as the source string, toe origmm string 1452 aM me 
occupy (13 * 2) = 26 bytes. 

Figure 33C illustrates an efficient method for representing and managing strings in general, and in small footprint 
40 systems such as embedded systems in particular. String 1452 is stored in memory as 12 bytes (no tammating 
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character is required). String structure 1460 includes pointers (Address(A) and Address(L)) to the first and last 

characters of string 1452. Using this string structure, the string's length may be efficiently computed by subtracting 

the pointer to the first character from the pointer to the last character. 

Operations such as string copy operations strcpyO and strncpyO may also be handled more efficiently. 

5 With string structures such as those illustrated in Figure 33C, a new string structure 1462 may be created, and the 

first and last character pointers may be initialized to point to me respective characters in string 145Z Thus, a 

portion or all the string 1452 does not have to be copied to new storage for me string. As strings can be hundreds or 

even thousands of characters long, the memory saved using the string structures and string methods implemented to : 

take advantage of them may be considerable. This method of handling copies of pordons or aU of a string may be 

10 called "substring management," as h deals with the efficient handling of portions (substrings) of strings. 

Other string functions rh>m the standard C string library may be replaced with string functions taking 

advantage of the string structure as illustrated in Figure 33C. Examples of other C string functions include, but are 

not limited to: strstrO, strcatO, and sprintfQ. The string ha ndl ing structures and methods as described in Figure 33C 

may be used, along with the hierarchical structure of XML documents, to provide more efficient handling of XML 

15 text (such as XML messages) in systems with small memory footprints such as embedded systems. The following is 

a simple example of an XML schema defining a purchase order 

<1D0CTVTE purchase.order SYSTEM "po.dtd"> 
<purchase.order> 
<date>22 May 2000</date> 
20 <^illing.address> 

<name>John Smifh</name> 
<street>123 Main</street> 
<city> Anywhere</ city> 
<state>MA<state> 
25 <zip>12345-6789</2ip> 
<Vbilling.address> 
<rtems> 
<item> 
<quantity>3</quantity> 
30 <productnumber>248<productnumber> 

<description>Decorative Widget, Red, Large</description> 
<umtcost>19.95<umtcost> 
</item> 
<item> 

35 <quantiry>l</quantity> 

<productnumber> 1 632</productnumber> 
<tfescription>Baltery, AA, 4-pacWdescription> 
<^initcost>4.95<^unitcost> 
</item> 

40 </items> 

.. </purchase.order> 

The hierarchical structure of XML documents may allow them to be processed in a recursive fashion with 
successively smaller portions of the document processed at each level of recursion. References to various portions 
45 are recorded and processed recursively. String structures as described in regard to Figure 33C may be used to 
record the various portions. In this manner, the content of specific XML tags (one line in the above example), in 
; one embodiment the smallest unit of the XML document processed recursively, may be determined efficiently. 
Documents with repeated tags in the same scope may also be handled efficiently, as tags within a given scope may 
be enumerated and processed efficiently. 

81 



WO 01/86394 



PCT/US01715134 



A recursive method for processing an XML document using string structures similar to those described in 
Figure 33C may accept a string structure representing the entire XML document string and pointing to the first byte 
and the last byte in the document string. The method may then locate the next subsection of the document and pass 
a string structure representing the substring of the entire document string containing the subsection to a processing 

5 function for the subsection type. The subsection itself may be broken into another level of subsections represented 
by string structures passed to processing functions for the subsection type. The method may continue in the 
recursive processing of the XML document subsections until the entire document has been processed. 

Using the string structures with the recursive processing allows the processing to be done without creating 
copies of the subsections for processing. Copying of subsections may be particularly costly in recursive processing, 

10 because as the recursion goes deeper, more and more copies of the same data are made. Using the string structures, 
only the string structure containing the pointers to the first and last bytes in the subsection needs to be created and 
passed down to the next leveL Other operations, such as determining the length of a subsection, may be performed 
efficiently using the address information stored in the string structures. Also, by using the string structures, 
terminating characters such as those used to terminate C strings are not necessary, conserving memory in small 

15 footprint devices such as embedded devices. , 

XML representation of Objects 

As previously mentioned, Jini RMI may not be practical for some clients, such as thin clients with rmnimal 
memory footprints and minimal bandwidth. The serialization associated with the Jini RMI is slow, big, requires the 
20 JVM reflection API, and is a Java specific object representation. Java deserialization is also slow, big and requires 
a serialized-object parser. Even Java based thin clients may not be able to accept huge Java objects (along with 
needed. classes) being returned (necessarily) across me network to me cUent, as requh^ m JinL 

A more scalable distributed computing mechanism may be provided by embodiments of a distributed 
computing environment A distributed computing environment may include an API layer for facilitating distributed 
25 computing. The API layer provides send message and receive message capabilities between clients and services. 
This messaging API may provide an interface for simple messages in a representation data or meta-daia format, such 
as in the extensible Mark-up Language (XML). Note that while embodiments are described herein employing 
XML, other meta-data type languages or formats may be used in alternate embodiments. In some embodiments, the 
API layer may also provide an interface for messages to communicate between objects or to pass objects, such as 
30 Java objects. Objects accessible through API layer 102 are represented by a representation data format, such as 
XML. Thus, an XML representation of an object may be manipulated, as opposed to the object itself 

The API layer may sit on top of a messaging layer. The messaging layer may be based on a representation 
dam format, such as XML. In one embodiment, XML messages are generated by the messaging layer according to 
calls to the API layer. The messaging layer may provide defined static messages that may be sent between clients 
35 and services. Messaging layer may also provide for dynamically generated messages. In one embodiment an 
object, such as a Java object, may be dynamically converted (compiled) into an XML representation. The object 
may include code and/or data portions. The object's code and/or data portions may be compiled into code and data 
segments identified by XML tags in the XML representation. .The messaging layer may men send the XML object 
representation as a message. Conversely, the messaging layer may receive an XML representation of an object The 
40 object may then be reconstituted (decompiled) from mat message. The reconsthution may examine the XML 
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representation for tags identifying code and/or data segments of the XML representation, and use information stored 
in the tags to identify and decompile the code and/or data portions of the object 
Creating and sending an XML representation of an Object 

Figure 34 illustrates a process of moving Java objects between a client 1500 and a service 1502 according 

5 to one embodiment Service 1502 may be any service supported in the distributed computing environment, 
including space services. Client 1500 employs a gate 1504, which may have been created using an XML schema 
received from a service advertisement for service 1502, to communicate with a corresponding gate 1506 for service 
1502. At some point, client 1500 may need to send Java object 1510 to service 1502. Java object 1510 may 
reference other objects, which may in turn reference other objects, and so on. Java object 15 10 and its referenced 

10 objects, the objects they in turn reference, and so on, may be referred to as an object graph. 

Java object 1510 may be passed to a Java object compilarion process 1512 to be compiled to produce an 
XML representation of the object graph. The XML representation of the object graph may be passed as an XML 
data stream 1514 to gate 1504. The XML data stream 1514 may include an XML representation of all the objects in 
the object graph. In one embodiment, the objects in the object graph may be stored recursively in the XML data 

15 stream 1514. 

Gate 1504 may then package the XML data stream 1514 in a message 1516 and send the message 1516 to 
gate 1506 of service 1502. Gate 1506 may extract the XML data stream 1514 from XML message 1516 and send 
the XML data stream 1514 to an XML data stream decompilation process 1518 to be decompiled to produce the 
objects) comprising the object graph, including Java object 1510. In one embodiment, the objects in the object 
20 graph may be stored recursively in the XML data stream 1514, and thus a recursive decompilation process may be 
used. 

When service 1502 needs to send a Java object to client 1500, a substantially sirnilar process may be used 
Java object 1520 may be passed to a Java object compilation process 1512 to be compiled to produce an XML 
representation of the object graph. The XML representation of the object graph may be passed as an XML data 
25 stream 1522 to gate 1506. Gate 1506 may then package the XML data stream 1522 in a message 1524 and send the 
message 1524 to gate 1504 of client 1500. Gate 1504 may extract the XML data stream 1522 from XML message 
1524 and send the XML data stream 1522 to an XML data stream decompilation process 1518 to be decompiled to 
produce the objects) comprising the object graph, including Java object 1520. 

In another embodiment, the gates may be responsible for the compilation and decompilation of Java 
30 objects. In this embodiment, Java object 1510may be jjassed to gate 15(M. Gate 1504 may 

to a Java object compilation process 15 12 to be compiled to produce an XML representation of the object graph in 
an XML data stream 1514. Gate 1504 may then package the XML data stream 1514 in a message 1516 and send 
the message 1516 to gate 1506 of service 1502. Gate 1506 may extract the XML data stream 1514 from XML 
message 1516 and send the XML data stream 1514 to an XML data stream decompilation process 1518 to be 
35 decompfled to produce me objects) comprising the object graph, including Java object 1510. The process of 
sending a Java object from service 1502 to client 1500 may be substantially similar to the process of sending an 
object from the client to the service. 

In one embodiment, object compilation process 1512 and object decompilation process 1518 may .both 
exist on the client 1500 and the service 1502, and may be programmed to perform compilation and decompilation 
40 substantially similarly on the two devices, thus ensuring the objects) output on one end are substantially identical to 
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the objects) input on the other end In one embodiment, XML schemas including descriptions of Java objects may 
be used on both the client and/or the service in the compilation and decompilation processes. In one embodiment, 
XML schema(s) to be used in the compilation and decompilation of Java objects may be passed by the service to the 
client in the service advertisement 
5 XML provides a language- and platform-independent object representation format Thus, the process as 

illustrated in Figure 34 where an object is compiled into an XML representation of the object and decompiled to 
reproduce the object may not be limited to moving Java objects, but in some embodiments may be applied to 
moving objects of other types between entities in a network. 

10 JVMcompilation/decompilationAPi 

Figures 35a and 3Sb are data flow diagrams illustrating embodiments where a virtual machine (e.g. JVM) 
includes extensions for compiling objects (eg. Java Objects) into XML representations of me objects, and for 
decompiling XML representations of (Java) objects into (Java) objects. The JVM may supply an Apphcations 
Prograrnming Interface (API) to the compilation/decompilation extensions. The client 1500 and service 1502 may 
15 be executmg within JVMs. The JVMs may be on the same device or on different devices. 

In both Figure 35a and Figure 35b, the JVM XML compiler/decompiler API 1530 may accept a Java 
object 1510 as input, and output an XML representation of the object 1510 and all its referenced objects (the object 
graph of object 1510) in an XML data stream 1514. In addition, the JVM XML compiler/decompiler API 1530 
may accept an XML data stream 1 522, which includes an XML representation of object 1520 and all its referenced 
20 objects (the object graph of object 1520), and output Java object 1520 (and all the objects in its object graph). 

Figure 35a illustrates one embodiment where, when sending Java object 1510, the client calls the JVM 
XML compiler/decompiler API 1530. Hie client 1510 passes Java object 1510 to the API 1530, which compiles the 
object to produce its XML representation, stores the XML representation in XML data stream 1514, and outputs 
XML data stream 1514. The client may then pass XML data stream 1514 to gate 1504. Gate 1504 may men 
25 package the XML data stream 1514 in an XML message 1516 and send message 15 16 to service 1502. 

Upon receiving XML message 1524 from service 1502, gate 1522 may extract XML data stream 1522 
from message 1524 and pass data stream 1522 to client 1500. Client 1500 may then call the JVM XML 
compiler/decompiler API 1530, passing API 1530 the XML data stream 1522. The API 1530 may then decompile 
the XML data stream 1522 to produce Java object 1520 and other objects in its object graph, returning the objects to 
30 client 1500. 

Figure 35b illustrates another embodiment where, when sending Java object 1510, the JVM XML 
compiler/decompiler API 1530 is called by the gate. The client 1510 passes Java object 1510 to gate 1504. Gate 
1504 then passes object 1510 to API 1530, which compiles the object to produce its XML representation, stores the 
XML representation in XML data stream 1514, and outputs XML data stream 1514. Gate 1504 may then package 
35 the XML data stream 1514 in an XML message 1516 and send message 1516 to service 1502. 

Upon receiving XML message 1524 from service 1502, gate 1522 may extract XML data stream 1522 
from message 1524 and pass data stream 1522 to the JVM XML compiler/decompiler API 1530. The API 1530 
may then decompile the XML data stream 1522 to produce Java object 1520 and other objects in its object graph. 
The gate may then send Java object 1520 and the other objects to client 1500. 
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In one embodiment, the JVM XML compiler and decompfler may be implemented as integrated functions 
of the JVM. In another embodiment, the XML compiler and decompfler may be embodied in API method 
invocations in standard extensions to the JVM; thus, the core JVM does not have to be modified. The JVM may 
supply the JVM XML compiler/decompiler API 1530 to processes (clients and/or services) executing within the 
JVM to allow the processes to access the Java object compflanon/decompilation functionality provided by the JVM 
In one embodiment, for a process to utilize the object compUation/decompflation, the JVM within which the process 
is executing must have the JVM XML compiler/decompiler functionality and API 1530. 

Methods using reflection and serialization to transform and send objects are typically implemented in 
applications separate from the JVM The application must repeatedly access the JVM to pick apart an object one 
) field at a time as the transitive closure of the object is dynamically analyzed litis tends to be a slow arid 
cumbersome process, while also requiring large amounts of application and JVM code. 

Implementing the Java object compuation/decompilation functionality within the JVM is advantageous 
because the JVM already understands the concept of, and contents at, an object graph. Thus, die 
compilation/decompilation functions may leverage the knowledge (and reuse code) of the JVM in parsing the object 
5 graph to produce the XML representation, and in parsing the XML representation to produce the object graph. 
Thus, the compilation/decompilation functions may not have to duplicate functionality that is provided by the JVM, 
as do object sending methods nsing reflection and serialization. This may allow die code footprint of die 
compaation/decompilation functions to be smaller than that of object sending methods using reflection and 
serialization. Also, an object may be complied or decompiled by a single call to the JVM XML 
20 compiler/decompiler APL 

In addition, integrating the compUation/decnmpilation of objects with the JVM may allow the compilation 
and decompilation of objects to be performed faster than methods nsing reflection and serialization because, in the 
object traversal model implemented with reflection and serialization, the code outside the JVM does not know die. 
structure or graph of the Java object, and thus must traverse the object graph, pulling it apart, and ultimately must 
25 repeatedly call upon the JVM to do the compilation (and the reverse process for decompilation). This process may 
be slowed by the necessity of making repeated calls to the JVM, outside the code. Having the compilation and 
decompilation functionality integrated with the JVM as described herein, avoids having to make repeated calls from 
code outside the JVM to the JVM In one embodiment, an object may be complied or decompiled by a single call to 
the JVM XML compiler/decompiler APL 
30 in one embodiment, the compilation/decompilation fonctionalKy may be implemented as a service in the 

distributed computing environment The service may publish a service advertisement in a space. A process in the 
distributed computing environment may use a search or discovery service to locate the compilation/decompilation 
service. The process (a client of the service) may then use the service by passing Java objects to be compiled into 
XML representations and/or XML representations to be decompiled into Java objects to the service. 
35 Java objects may include code (the object's methods) and data. An object's code may be non-transient; the 

code does not change once the object is created An object's data, however, may be transient Two objects created 
from the same Java class may include identical code, but the data in the two objects may be different In one 
embodiment, the compilation function may compile a Java object's data into an XML representation of the object, 
but may not include the object's actual code in the XML representation. In one embodiment, information about the 
40 object may be included in the compiled XML representation to indicate to the receiver how to recreate the code for 
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the object Hie XML representation may men be stored in an XML data stream and sent (e.g. in a message) to a 
receiving process (client or service). The receiving process may then pass the XML data stream to the . 
decompilation function. The decompilation function may then decompile the XML data stream to produce the Java 
object including its data. In one embodiment, the code for the object may be reproduced by the decompilation 
5 function using information about the object included in the XML representation, as the code for an object may be 
statically defined and the JVM receiving me object may be able to reproduce the code (if necessary) using its 
knowledge of the object 

In one embodiment, the XML representation of an object produced by the compilation function may 
include the Java object's data and information about the Java object The information may include class information 
10 for the Java object An object signature may be included* the information and may be used to identify me objerf^ 
class, etc. The decompilation function may recreate me code for toe Java object usmg the infonn^^ 
Java object and may decompile the data from the XML data stream into the Java object Thus, a complete object 
including its code and data may be reproduced on the JVM executing the receiving client or service from the 
decompiled data and the information describing the object In one embodiment, the information describing the 
15 object may be stored in one or more XML tags. In one embodiment the client or service receiving the XML data 
stream may include an XML schema that describes the object, and the XML schema may be used to reconstruct the 
Java object from the decompiled data and from me information about the Java object The decompilation process 
may proceed recursively through the object graph, reeonstructing the objects referenced by the object by 
decompiling the referenced objects' data from the XML data stream and recreating the referenced objects' code 
20 from information about the referenced objects in the XML data stream. 

In one embodiment the XML representation of the object produced by toe compilation function may 
include the object's data and information mat identifies the code of an object In one embodiment the information 
identifying the code of the object may be stored in one or more XML tags in the XML data stream. When received, 
the decompilation function may recreate the code for the Java object using toe information about the code from the 
25 XML data stream and decompile the data for the object from the XML data stream. Thus, a complete object 
including its code and data may be reproduced on toe JVM executing the receiving client or service from toe 
decompiled data and the information describing the code of the object 

Several scenarios of using XML representations of objects to transfer objects between entities (typically 
clients and services) in a distributed computing environment are included for clarification. These scenarios are 
30 exemplary and are not intended to be limiting. 

In a first scenario, a service may use toe XML compiler/decompiler to compile a Java object into an XML 
representation of toe object and send the XML representation to a client The client may the use the XML 
compfler/decompfler to decompile the XML representation and perform operations on the data within the object, 
and later may use the XML compiler/decompiler to compile the object into an XML representation of the object and 
35 return the XML representation of toe object to the service. 

In a second scenario, a service may use toe XML compiler/decompiler to compile a Java object into an 
XML representation of toe object and send the XML representation to a client The client may then send the XML 
representation to another service, which may use toe XML conquer/decompiler to decompile the XML 
representation to reproduce toe object, perform operations on toe object at toe request of the client (possibly 
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modifying the data), use the XML complex/decompiler to recompile the modified object into its XML 
representation, and send the XML representation of the object to the client 

In a third scenario, a service may use the XML compiler/decompiler to compile a Java object into an XML 
representation of the object and send the XML representation to an object repository or store space. The service 
5 may then send a message to a client informing the client of the location of the XML representation. The message 
may include a Universal Resource Identifier (URI) for the XML representation. The client may then retrieve the 
XML representation of the object from the store space, and may use the XML compiler/decompiler to decompile the 
representation to reproduce the object Alternatively, the client may send the location of the XML representation of 
me object to another service, along with a request for operations to be performed on the object The other service 
10 may then retrieve the XML representation from the store space, use the XML ccnipuer/decoinpiler to decompile the 
XML representation to reproduce the object, and perform the requested operations on the object 

In a fourth scenario, a process (could be a client or service) may locate an object repository or store space 
in the distributed computing environment by searching for and finding a service advertisement for the store space. 
The process may, during execution, create or obtain a plurality of Java objects. The process may use the XML 
15 compiler/decompiler to compile one or more of the objects into XML representations of the objects, and may send, 
as a client of the store space service, the XML representations of the objects to the store space to be stored for 
possible later access, or for access by other processes. 

Security issues in the Decompilation of XML Representations of Objects 

Spaces, as described herein, may serve as a file system in the distributed computing environment Security 
20 maybeprovidedforfflesmmesystemmmeformofaccessrights. Ac<^ rights may be checked each time a file is 
accessed (opened, read, or written to). Thus, a method for providing file access security in the distributed . 
computing environment may be desirable. This method may also be applied to the XML representations of Java 
objects that may be stored in spaces and transmitted between clients and services in the distributed computing 
environment 

25 In one embodiment a user of a client on a device in the distributed computing environment may be 

identified and authenticated when first accessing the client In one embodiment the user may supply a physical 
identification such as a smart card for identification and authorization. In another embodiment, a challenge- 
response mechanism (such as user ID and password) may be used for identification and authorization. Yet another 
embodiment may use electronic identification such as a digital signature for identification and authorization. Any 
30 other method of identification and authorization may be used. 

Once identified and authorized, the user may then perform various operations on the client, including 
accessing one or more services in the distributed rornputing environment During these operations, as described 
above, one or more objects may be created (locally) or acquired from elsewhere (e.g. from services or spaces). The 
objects may be modified and may be compiled into XML representations of the objects and stored locally by the 
35 client or sent to a space service for (transitive or persistent) store. Some of the objects may be received from 
services (store services or other services) in the form of XML representations of the objects, which may be 
decompiled by the XML compiler/decompiler to recreate the objects on the client 

In one embodiment during the decompilation of the XML repxsentation of objects, each XML message 
may be checked to verify that the user has access rights to the object If the user does not have the proper access 
40 rights, the XML compUer/decompiler may not decompile the object for foe user. In one embodiment, a security 
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exception may be thrown by the XML compiler/decompiler. In one embodiment, the user may be informed of the 
access violation. 

Access right information, such as the creator and access levels allowed (creator-only access, read only, 
read/write, delete, copy, etc.) for the object may be embedded in the XML message(s) containing the XML 
5 representation of the object Access authorization may be determined during the identification and authorization of 
the user.. For example, the object may allow "read only" access for most users, and tt read/write n access for the 
creator of the object If the user tries to access an object using read/write access rights, and the user did not create 
the object, the decompilation process may detect mis as an access violation, and may disallow the access and notify 
me user. 

10 In one embodiment, when the user is done using the client, the user may log offer otherwise signal the user 

is finished with the client (e.g. remove a smart card). Objects created on the client by decompflation may be 
automatically deleted when the client detects that the user is finished This may prohibit future users from 
intentionally or accidentally accessing the user's objects. In one embodiment, all objects created by decompilation 
may be deleted upon detecting mat the user is finished. In another embodiment, a method may be provided to store 

15 at least some of the objects created on the client persistently (e.g. with access rights mformanon), so mat the client 
may later access the objects, or provide the objects to other users for access. 

In one embodiment, the user may have a "smart caTtf' or omer physical device 
The user may insert the smart card into the client device to begin the session. When the client is finished, the client 
may remove the smart card. The client may detect the removal of the smart card, and thus detect that the client is 

20 finished, and may then proceed to delete objects created by decompilation of XML representations. 

XML-based object repositories 

In the distributed computing environment, processes (services and/or clients) may desire transient and/or 
persistent storage of objects such as XML schemas, service advertisements, results generated by services, XML 
25 representations of Java objects and/or objects implemented in other languages, etc. Existing object storage 
technologies tend to be language and/or operating system specific. These storage systems also tend to be too 
complicated to be used with small footprint systems such as embedded systems. 

JavaSpaces in Jini is an existing object repository mechanism. A JavaSpace may be only capable of storing 
Java objects and may be too large to be implemented in small devices with limited amounts of memory. Each object 
30 in a JavaSpace may be serialized as previously described, and thus has the same limitations as previously described 
for the reflection and serialization techniques. 

A store mechanism may be provided for the distributed computing environment that may be heterogeneous 
(not language or operating system dependent), that may scale from small to large devices, and that may provide 
transient or persistent storage of objects. In one embodiment, the store mechanism in the distributed computing 
35 environment may be implemented as an Internet Web page or set of pages defined in the XML markup language. 
XML provides a language- and platfcnm-mdependent object representation format enabling Java and non-Java 
software to store and retrieve language-independent objects. Since the store mechanism is on the Web, devices of 
all types and sizes (small to large) may access the store mechariisms. Web browsers may be used to view the store 
mechanism implemented as Web pages. Web search engines may be used to search for contents in the store 
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mechanism implemented as Web pages. Internet administration mechanisms (existing and future) and XML took 
may be used to administer me XML-based store mechanisms. 

In one embodiment, the store mechanisms may be used to store objects created, represented or 
encapsulated in XML. Examples of objects that may be stored in the store mechanisms may include, but are not 
limited to: XML schemas, XML representations of objects (for example, Java objects compiled into XML 
representations as described above), service advertisements, and service results (data) encapsulated in XML. In one 
embodiment, to prevent unauthorized access of an XML object, an authorization credential such as a digital 
signature or certificate may be included with the XML object, and a client wishing to access the XML object may be 
required to have the proper authorization credential to access the XML object In one embodiment, the store 
mechanism may be a space as described m the Spaces section herein. 

Store mechanisms may be services in the distributed computing environment. A store mechanism 
implemented as a service may be referred to as a "store service". A store service may publish an advertisement in a 
space. The space itself is an example of a store service. Some store services may be transient For example, a 
space service that stores service advertisements may be a transient store. Other store services may be persistent 
For example, a store service that stores results from services may be a persistent store. 

Figure 36 illustrates a client 1604 and a service A 1606 accessing store mechanisms 1600 and 1602 in the 
distributed computing environment according to one embodiment This illustration is intended to be exemplary and 
is not intended to be limiting to the scope of this invention. In one embodiment, store mechanisms 1600 and 1602 
may each be an Internet Web page or set of Web pages defined in XML and accessible by a Web browser and other 
Internet tools. Store mechanism 1600 is a transient store capable of storing objects implemented using XML. Store 
mechanism 1602 is a persistent store also capable of storing objects implemented using XML Service A 1606 may 
publish an XML service advertisement 1608 in transient store 1600. Persistent store may also publish an XML 
service advertisement in transient store 1600 (or on another transient store in toe distributed computing 
environment). At some point client 1604 may require functionality provided by Service A 1606. Client 1604 may 
use a discovery and/or lookup service to locate service advertisement 1608. Client 1604 may then construct a 
message gate, as described herein, and begin communications with Service A 1606. Client 1604 may send one or 
more XML request messages to Service A 1606. Service A 1606 may perform one or more functions in response to 
toe one or more request messages. One or more of the functions performed by Service A 1606 may produce results 
to be provided to client 1604. 

For transient results 1610, Service A 1606 may encapsulate the results in an XML advertisement 1612 and 
publish the advertisement 1612 in transient store 1600 (or on another transient store in the distributed computing 
environment). Service A 1606 may then notify client 1604 mat die results 1610 are stored in advertisement 1612 on 
transient store 1600, or client 1604 may be notified by other mechanisms as described herein. Client 1604 may then 
retrieve transient results 1610 from advertisement 1612. The advertisement 1612 may include an XML schema 
describing the formatting, contents, type, etc of the transient results 1610. The results may be encapsulated in 
XML For example, XML tags may be used to describe portions of the data: 
<XMLtagl> <datal> 
<XMLtag2> <data2> 
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For persistent results 1618, Service A 1606 may use a service or other mechanism as described herein to 
locate XML service advertisement 1616 for persistent store 1602, and thus locate persistent store 1602 for storing 
persistent results. Alternatively, client 1604 may have previously located persistent store 1602 by locating its 
service advertisement 1616, and then may send a Universal Resource Identifier (URI) for a storage location for 
5 persistent results 161 8 to Service A in an XML message. In one embodiment, persistent results 1618 may be stored 
in an Internet Web page or set of Web pages defined in XML and accessible by a Web browser. Service A 1606 
may then store persistent results 1618 in persistent store 1602. Service A 1606 may then publish an XML 
advertisement 1616 for the persistent results 1618 in transient store 1600 (or on another transient store in the 
distributed computing environment) and return the location of the advertisement 1616 to client 1604. The 
10 advertisement 1616 may include an XML schema describing the formatting, contents, type, etc. of the persistent 
results 1618. The results may be encapsulated in XML as previously described. The advertisement may also 
include the URI of the persistent results 1618. The client 1604 may then retrieve the advertisement 1616 and use it 
to locate and retrieve persistent results 1618. Alternatively, Service A 1606 may not publish an advertisement for 
persistent results 1618, but instead may return a URI for the persistent results 1618 to client 1604 so client 1604 
15 may access the results without looking up an advertisement Note in some embodiments, the various advertisements 
shown in transient store 1 600 may each be stored in different transient stores or spaces. 

Thus, store mechanisms may be implemented as XML-based Internet Web pages in the distributed 
computing environment These store mechanisms may be implemented on a variety of devices in the environment, 
and may provide service advertisements to allow clients (which may be other services) to locate and use the store 
20 mechanisms. Existing and future Web and XML tools may be used to manage the store mechanisms. The store 
mechanisms may store objects of various types implemented or encapsulated in XML. Clients on devices of 
substantially any size, from small footprint devices to supercomputers, may access the store mechanisms to store and 
retrieve the various objects on the Internet The clients may be Java or non-Java applications, as XML provides a 
language-independent storage format The transient or persistent object repositories may provide for a file system in 
25 the distributed computing environment and may include access checks and other security mechanism as described 
herein. 

Dynamically Converting a Java Object into an XML Document 

In one embodiment, the distributed computing environment may provide a mechanism to convert and 
represent an object class instance into an XML document In order to send representation of a class instance to 

30 another service, the object may be converted and represented as an XML document In one embodiment, when 
receiving an XML document, a program may instantiate a class instance corresponding to the object represented by 
the document In one embodiment, the objects may be Java objects, and the program may be a Java program. 

In one emtodiment, an intermediary format may be used to represent an XML document and may be 
dynamically processed to generate a class instance that represents the XML document The class may define a set of 

35 instance variables and "set and get" methods to access the instance variables. A corresponding XML document may 
be defined as a set of tags, with one tag for each instance variable. When the document is parsed, a hashable 
representation may be constructed where the hash key may include the instance variable name and the vame may 
include the instance variable value. If there are multiple , occurrences of a complex instance variable, an enumeration 
value may be stored in a hash table. In one embodiment, the process may be limited to only one level of complex 

40 types for the instance variables, and the elements may be homogeneous. 

90 



WO 01/86394 



PCT/US01/15134 



In one embodiment, a protected instance variable may be added to the class definition that may include the 
name of the corresponding class. The XML document representation may use the class name as the document type. 
Having the class name embedded in the document may allow dynamic instantiation of the right class instance when 
the object is reconstructed. 

In one embodiment, upon receiving a document, a class instance generator method may be used to extract 
the class type and to parse the document to generate the intermediary hash table representation. The generator 
method may instantiate a new class instance and may use the set methods to initialize the instance object from the 
hash table values. In one embodiment, since the class type is defined and the hash table is generic, mis process may 
be performed for any class that matches me above class definition. 

In one embodiment, the reverse process may also be performed where a class instance may be processed 
into the intermediary hash table representation and a generator method may be used to produce an XML document 
from the hash table representation. This process may also be made generic so that h may be performed for any XML 
document that matches the above specification. 

This method is not intended to be limited to Java Class objects, and may be applied to other computer- 
based objects, including class object instances of other progra mming languages. In addition, the method is not 
intended to be limited to XML representations of object instances; other representation formats including other data 
representation languages (such as HTML) may be substituted for XML. 

XML-Based Process Migration 

The distributed computing environment may enable the distribution and management of distributed 
applications. For example, the distributed computing environment may include mobile clients that are dockable 
with stations that provide monitors, printers, keyboards, and various other input/output devices that are typically not 
provided on mobile devices such as PDAs, cell phones, etc. These mobile clients may run one or more applications, 
and may migrate from one station to another in the distributed computing environment Thus, one embodiment of 
the distributed computing environment may provide a method for migrating an executing application (process) with 
its entire current state from a mobile client on one node to the same mobile client or another mobile client at another 
node within the distributed computing environment 

In one embodiment, an XML representation of the state of a process executing on a client or service may be 
created. In one embodiment, the XML representation of the state of the process may include a computation state of 
30 the device and/or virtual machine on which the process is executing, wherein the computation state of the device 
and/or virtual machine comprises infonnation about the execution state of the process on the device and/or virtual 
machine. A process state may include, but is not limited to: threads, all objects referenced by the threads, transient 
variables created during the execution of the process, objects and their data, etc. In one embodiment, data 
describing one or more leases representing grants of access to external services, obtained from spaces by the 
35 process, wherein the one ox more external services are external to the device and/or virtual machine on which the 
process is executing, may also be represented in XML and stored with the process state. Leases are described in 
more detail in the Leases section of mis document 

Using XML and the messaging system as described herein, an XML representation of the state of a process 
may be moved from node to node within the distributed computing environment, e.g. from node to node on the 
40 Internet The XML representation of the state of a process may also be stored as an XML object in an XML-based 
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store mechanism as described above, and later retrieved from the store mechanism to resume the process execution 
on the same node or on a different node in the distributed computing environment In one embodiment, the XML 
object compilation/decompiiation process as described herein may be used in creating (compiling) an XML 
representation of the state of a process and in regenerating the state of the process by decompiling the XML 
representation of the state of the process. 

Using mis mechanism, an XML representation of the state of a process may be stored in an XML-based 
store mechanism, such as a space, from an initial node. Subsequently, another node may locate the stored state of 
the process, download the state of the process, and resume the process from the downloaded stored state at the point 
at which it was executing when the state was stored Since the process state is stored in an XML format, the tools 
and search facilities described herein to store, locate and retrieve XML objects in XML-based store mechanisms 
may be used to enable me migra^ An ao^rertisement of the stored XML representation of the state 

of the process may be published to allow a client resuming the process execution on the same node or another node 
to locate and access the stored sate. 

The XML representation of the state of a process may be stored to an XML-based persistent store 
> mechanism, and thus may provide a persistent snapshot of the process. This may be used as a method to resume 
process execution on a node after the mterruption of the process on the node, for example, due to the intentional or 
rmmtentional shutdown of the node. An advertisement of the stored state of the process may be published to allow 
clients to locate the stored state in the distributed computing environment In one embodiment, to prevent 
unauthorized access of an XML representation of the stored state of a process, an authorization credential such as a 
digital signature or certificate may be included with the stored state, and a client wishing to resume a process from 
the stored state may be required to have the proper authorization credential to access the stored state. 

Figure 37 illustrates process migration using an XML representation of the state of a process according to 
one embodiment Process A 1636a may be executing on node 1630. Process A 1636a may be a client or service. 
At some point during the execution of Process A 1636a, the state of execution of Process A 1636a may be captured 
25 and stored in an XML-encapsulated state of Process A 1638. The execution of Process A 1636a on node 1630 may 
then be stopped. Later, node 1632 may locate the XML-encapsulated state of Process A 1638 and use it to resume 
Process A 1636b on the node 1632. Resuming Process A may include using the stored state 1638 to resume thread 
execution, recalculate transient variables, re-establish leased resources, and perform any other functions necessary to 
resume execution as recorded in the stoicd XML state of the process 1638. 
30 The following is an example of using XML-based process migration in the distributed computing 

enviromnent, and is not intended to be limiting. A mobile client device may be connected to node 1630 and 
executing Process A 1636a. The user of the mobile client device may desire to stop execution of Process A 1636a 
on node 1630, and to resume execution at a later time at another (or the same) node. In one embodiment, the user 
may be prompted with a query to determine if the user wishes to store the state of Process A 1636a and resume 
35 execution later. If the user replies in the affirmative, the XML-encapsulated state of the process may be captured 
and stored in persistent store 1634. Later, the user may connect the mobile conmuting device at node 1632. In one 
embodiment, the user may then execute process 1636b and select a "Resume fiom Stored State" option. The node 
• 1632 may then search for and locate the XML-encapsulated state of Process A 1638, download it, and use it to 
resume Process A 1636b. Alternatively, the process may itself know that it was "suspended" on another node, and 
40 may resume from the stored state without user input 
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Applications 

Technologies exist that allow a user to access network data from remote locations, making the remote data 
appear as local data to the user, provided the user has access to a browser. However, such technologies do not 
5 provide an automatic mfrastructure to query networks near a client device's location. A mechanism for discovering 
information about networks and services near a client device may be desirable. For example, such a mechanism 
may be used to locate information about restaurants, weather, maps, traffic, movie information, etc within a certain 
distance (radius) of the client device, and to display desired information on the client device. An example of using 
this mechanism may be a cell phone that can be used to automatically locate services in a local environment, for 
10 example, in a movie theater to display the titles and show times of current features in the movie theater or in a 
restaurant to view menu selections and prices. In the distributed computing environment as described herein, such a 
mechanism may be used to discover spaces including local information and/or services proximate to the client 
device. The mechanism may also be applied in other distributed computing environments, for example, the Jini 
system from Sun Microsystems, Inc. 
IS In one embodiment, a mobile client device may include Global Positioning System (GPS) capability and 

wireless connection technology. Local distributed confuting networks may be provided For example, a city may 
provide a citywide distributed computing environment Another example may be a shopping mall with a local 
distributed computing environment A local distributed computing network may include a discovery mechanism to 
allow client devices to connect to the distributed computing environment and to discover services and data in the 
20 local environment For example, one or more devices in the environment may include wireless connection 
technology to allow mobile client devices to connect to the network and to access the discovery mechanism via the 
XML messaging system as described previously. A local distributed computing environment may include one or 
more spaces with advertisements for services and/or data to be made available to mobile clients. For example, a 
citywide distributed computing environment may include spaces that represent entities such as malls, movie theaters, 
25 local news, local weather, traffic, etc. A space may include individual service and/or data advertisements for 
accessing services of and information about the entity the space represents. The discovery mechanism may include 
a GPS location or locations of the local distributed computing environment, entities represented by space services 
within the environment, and/or the various services advertised in the spaces in the environment 

In one embodiment, wired connections may be provided to a local distributed cc>rnputing network. In mis 
30 environment, a user with a mobile client device may "plug in" directly to the network using a wired connection 
"docking station". Examples of wired connections include, but are not limited to: Universal Serial Bus (USB), 
Fire Wire, and twisted-pair Internet In one embodiment, a docking station may also provide input/output 
capabilities such as a keyboard, mouse, and display for the mobile client device. In this embodiment, the location of 
the mobile client device may be provided to the lookup or disco very mechamsm by me 
35 in on e embodiment, a mobile client device may connect to a distributed computing network. As the user of 

the mobfle client device navigates within wireless communications range of the distributed computing network, the 
mobfle client device may constantly, or at various intervals, provide a location Vector as input to the local lookup or 
discovery mechamsm The mobile client device may obtain the location vector from a GPS system built into or 
associated with the mobfle client In one embodiment, the client may send its location information (e.g. via XML 
40 messaging) to a local service discovery mechanism, such as one of the space location mechanisms described herein. 
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For example, the client may run the space discovery protocol specifying discovery for spaces offering services 
within a certain range of the client's location, or me client may instantiate a space search service to search for spaces 
advertising services provided for the client's vicinity. 

As the mobile client device moves into a specified range of a space within the distributed computing 
5 environment, the services and/or data stored in the space may be made available to the mobile client device. In 
embodiments where the client device regularly provides its location to a discovery mechanism, local services and/or 
data may automatically be made available to the client's user. In one embodiment, the user of the mobile client 
device may deterrnine the specified range of a space. For example, the user may choose to display all restaurants 
within one mile of a current location. Alternatively, the range may be specified in the configuration of the local 
10 distributed computing network. For example, a citywide distributed computing network may be configured to 
provide its services to all users within three miles of the city limits. In one embodiment, visual indicators, for 
example icons, representing the various services and/or data offered by the space may be displayed on the mobile 
client device. The client may then access one or more of the displayed services and/or data. In one embodiment, 
information from two or more spaces may be displayed simultaneously on the mobile client device. In one 
15 embodiment, the user may select what services and/or data are to be detected. For example, in a shopping mall, a 
user with a mobile client device may choose to display all shoe stores in the malL 

In one embodiment, executable code and/or data used in the execution of the code may be downloaded to 
the mobile client device to allow the user to execute an application provided by a service in the space. For example, 
moviegoers with mobile client devices may download interactive movie reviews from services in a space for the 
20 movie theater, and may thus perform real-time feedback about the movie they are watching. In one embodiment, an 
XML object compilation/decompilation mechanism as described elsewhere herein may be used to compile the code 
and/or data to produce XML representations of the code and/or data, and to decompile the XML representations to 
reproduce the code and/or data on the mobile client device. In one embodiment, an executable version of a process 
may previously exist on the mobile client device, and a stored state of the process may be downloaded to the mobile 
25 client device to allow the user to execute the process using the stored state. In one embodiment, an executable 
version of a process may previously exist on the mobile client device, and data for the process may be downloaded 
to the mobile client device. For example, data may be downloaded for viewing wim a viewer program on me mobfle 
client device. In one embodiment, an executable version of a process, including the code and data for executing the 
process, may be downloaded for execution on the mobile client device. In one embodiment, the service may execute 
30 the apphcation remotely on behalf of the mobile client device, and the service and client may pass to each other 
XML messages including data and optionally XML schemas describing the data. In one embodiment, some code 
may be executed on the service and some on the client For example, the service may execute code to perform 
operations on a set of data such as numerical calculations. The mobile client device may execute code that may 
display portions of the data passed to the client from the service in XML messages and allow the user of the mobile 
35 client device to enter and/or select data and send the data to the service for rjerforaiing one or more operations on 
the data. 

In one embodiment, a mobile client device may be connected to two or more services in the distributed 
computing network simultaneously. The services may be used mdependentry or in conjunction for performing a 
series of tasks. For example, one service may be used by a remote client device to locate and/or perform operations 
40 on a set of data, and a second service may be used to print the set of data. 
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Figure 38 illustrates a mobile client device accessing spaces in a local distributed computing network, 
according to one embodiment A user of GPS-enabled mobile computing device 1700 may move into proximity of a 
local distributed computing environment Hie mobile client device 1700 may provide its location provided by GPS 
1702 to one or more discovery mechanisms 1706 in the local distributed computing network. The discovery 
mechanism 1706 may use the provided GPS location of the mobile client device and predetermined locations of 
spaces within the environment to determine when the user moves within a specified range of one or more spaces or a 
vicinity served by one or more spaces withm the environment For example, discovery mechanism 1706 may 
determine mat mobile client device 1700 has moved within range of space 1704. Discovery mechanism 1706 may 
then provide one or more advertisements 1710 from space 1704 to the mobile client device 1700. Alternatively, 
discovery mechanism 1706 may provide a Universal Resource Identifier (URI) for space 1704, or for one or more 
advertisements in space 1704, to mobile client device 1700. Icons representing the various services advertised by 
service advertisements 1708 and/or data represented by content advertisements 1710 may then be displayed on 
mobile client device 1700. The user may then select one or more of the advertised services and/or data for 
execution and/or display on the mobile client device. The mobile computing device 1700 may establish a wireless - 
connection with the device offering the service and communicate with the device to execute the service using the 
XML-based messaging system as previously described herein- Alternatively, the user of the mobile computing 
device 1700 may connect the device at a docking station. The location of the docking station may have been 
discovered by the user using the lookup or discovery mechanism 1706, and spaces containing advertisements for the 
docking stations to discover the location and availability of docking stations within a specified range of the user. 

Discovery mechanism 1706 may also detect when mobile client device 1700 moves into a selected range of 
space 1714. The various service advertisements 1718 and content advertisements 1720 may then be made available 
to the user of the mobile client device 1700. When the mobile client device moves out of the specified range of one 
of the spaces, the advertisements offered by that space may be removed from the mobile client device 1700's 
display. 

In one embodiment, advertisements on a space may include location information for the services or data 
that they provide. Thus, discovery mechanism 1706 may determine when mobile client device 1700 moves within a 
specified range of a particular service advertised on space 1718, and may provide (or remove) the service 
advertisement based upon the location of the mobile client device 1700. 

Computing devices are shrinking while at the same time gaining power and functionality. Storage devices, 
CPUs, RAM, I/O ASICS, power supplies, etc. have been reduced in size to where small, mobile client devices may 
include much of me tmctionalicy of a full-sized personal computer. However, some components of a computer 
system are not easily shrinkable because of the human factor and other actors. These components include, but are 
not limited to: keyboards, monitors, scanners, and printers. The limits on reducing the size of some components 
may prevent mobile client devices from truly assimung the role of personal computers. 

In one embodiment, docking stations may be provided mat allow users with mobile client devices to 
connect to and use components that are not available on the mobile client device because of human or other fectors. 
For example, docking stations may be provided in public places such as airports or libraries. The docking stations 
may provide monitors, keyboards, printers or other devices for users with mobile client devices. In one 
embodiment, the docking stations may not fully function without help from a real computing device such as a mobile 
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client device connected by a user. The docking station may provide services such as various input/output functions 
to the client using the computing power of the mobile client device. 

A docking station may provide one or more connection options to a mobile client device. The connection 
options may include wireless connections and wired connections. Examples of wireless connections include, but are 
5 not limited to: infrared such as IrDA and wireless network connections similar to those provided by a network 
interface card (NIC) in a notebook computer. Examples of wired connections include, but are not limited to: USB, 
FireWire, and twisted-pair Ethernet 

A mobile client device may discover the location of docking stations using a method substantially similar to 
that described above for mobile client devices. The location of one or more docking stations in a local distributed 
10 computing network may be discovered using a discovery mechanism to discover spaces with advertisements for 
docking stations. The mobile client device may provide a location to the discovery mechanism. In one 
embodiment, the discovery mechanism or a lookup mechanism may return the location of one or more docking 
stations closest to the location of the mobile client device. Alternatively, the discovery mechanism or lookup 
mechanism may return a URI of the space containing the advertisements for the docking stations, and the mobile 
15 client device may then connect with the space to provide the location of the one or more docking stations near the 
device. In one embodiment, the mobile client device may supply information to the lookup or discovery mechanism 
to specify requirements such as monitor resolution, screen size, graphics capabilities, available devices such as 
printers and scanners, etc. In one embodiment, information about the one or more docking stations may be supplied 
to the user on the mobile client device including availability (is another user using the docking station), components 
20 and capabilities of the various docking stations. 

When a user approaches a docking station, a claiming protocol may be initiated. When the docking station 
accepts the claim, secure input and output connections may be established between the mobile client device and the 
docking station. Alternatively, the user may select the docking station from one or more docking stations discovered 
using the lookup or discovery mechanism displayed on the mobile client device. When the user selects the docking 
25 station, the claiming protocol may be initiated to give the user secure, exclusive connection to the docking station 
for the duration of the claim. A docking station release method may also be provided to allow the user to terminate 
the session on the docking station and release the docking station for use by other users. In one embodiment, the 
claiming protocol may be a lease on the docking station service as described previously herein. 

Figure 39a illustrates a user of a mobile device discovering the location of docking stations according to 
30 one embodiment Mobile client device 1750 may connect with discovery mechanism 1756. Mobile client device 
1750 may provide a location obtained using GPS 1752 to discovery mechanism 1756. Mobile client device 1750 
may also provide docking station requirements to discovery mechanism 1756. Discovery mechanism 1756 may 
search one or more spaces 1754 for advertisements for docking stations 1758 that meet the requirements of mobile 
client device 1750. In one embodiment, a lookup or discovery mechanism may locate one or more docking stations 
35 within a specified range of mobile device 1750 by comparing location information stored in advertisements 1758 
with the supplied location of mobile device 1750. Discovery mechanism 1756 may then provide the location of one 
or more docking stations within a specified range of mobile client device 1750. Altematrvery, discovery mechanism 
1756 may locate a nearest docking station to mobile client device 1750 and provide the location to mobile client 
device 1750. 
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Figure 39b illustrates a mobile client device 1750. connecting to a docking station 1760, according to one 
embodiment In one embodiment, the user may move mobile client device 1750 into wireless range of docking 
station 1760 and make a wireless connection to the docking station 1760. In another embodiment, the user may 
establish a wired connection to docking station 1760 by connecting one or more cables between docking station 
5 1760 and mobile client device 1750. In one embodiment, the user of the mobile client device 1750 may establish a 
claim to the docking station 1760. The claim may establish secure, exclusive rights to the docking station for the 
duration of the connection. In one embodiment, the claim mechanism may be a lease mechanism for a resource (the 
docking station) as described previously herein. In one embodiment, a user may be billed for use of the docking 
station. For example, the user may supply a credit card number as part of the process of claiming a docking station. 
10 Refer to the description of bill gates in the Message Gates section herein. Once connected, the user may use the 
various facilities provided by the docking station 1760 such as keyboard, monitor, printer, eta Docking station 
1760 may also include a connection to a local distributed computing network and thus may provide the user of the 
mobile client device 1750 connected to the docking station 1760 with discovery services for locating service and 
content advertisements on other devices within the network, allowing the user to locate and use various services and 
15 content in the distributed computing environment as described previously herein. 

When finished, the user may disconnect the mobile client device 1750 from the docking station 1760. In 
one embodiment, a docking station release mechanism may automatically be initiated when the mobile client device 
1750 is disconnected from the docking station 1750. The release mechanism may clear any claim on the docking 
station 1760 established by the user of the mobile client device 1750. In one embodiment, the release mechanism 
20 may notify the discovery mechanism 1756 and/or docking station advertisement 1758 that the docking station is 
available. 

In one embodiment, a user may connect a mobile client device to a docking station without using the 
discovery mechanism. For example* a user in an airport may visually detect a docking station and connect a mobile 
client device to ft. Another example may be a library providing a docking station room with a plurality of docking 
25 stations for use, where users may access any of the docking stations that are available. 

Small Footprint and/or Embedded Devices 

Simple embedded or small footprint devices may have limited amounts of memory for storing and 
executing program instructions. A simple embedded device may need to understand a limited set of control inputs 

30 for inmating functionality of the device and outputs for reporting the status of the device. An example of a simple 
embedded device is a "smart" switch (such as a light switch) with embedded circuitry for controlling the switch and 
thus the device controlled by the switch. Hie smart switch may only need to understand two control requests 
(change the state of the device, request the state of the device) and to send one status message (the state of the 
device). The smart switch may manage the device to which it is connected by receiving its control requests from 

35 one or more control systems and reporting status messages to the one or more control systems. 

In one embodiment, the distributed computing environment may provide a framework (protocol) for 
including small devices mat may not have the resource footprint (such as memory) necessary to implement the full 
protocol of the distributed computing environment In one embodiment, an agent may be provided as a bridge 
between the small device-capable protocol and the foil protocol The agent may perform the full protocol discovery 

40 for the small device, so the device may not be required to implement the full discovery protocol and service 
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activation. In one embodiment, the small device may only need to send service-specific messages. In one 
embodiment, these messages may be pre<ooked on the small device, so the small device may only have to send 
messages that are part of the service activation to the agent The agent may perform the service activation via the full 
protocol to the service and forward incoming message from the device to the service, and/or may forward replies 
5 from the service to the client Thus, the agent may act as a service connector forthe smailclient 

In one embodiment of the distributed computing environment an embedded device may be configured to 
receive a specific set of control requests in the form of XML messages and to send a specific set of XML messages 
to make requests, report status, etc. In one embodiment a control system may be configured to manage a variety of 
devices by sending XML request messages specific to each device or category of device that it controls and by 
10 receiving XML messages from me devices. In one embodiment, one or more XML schemas may be used to define 
an embedded device's specific set of XML messages; the schema may be used by the embedded device and/or the 
control system in sending and receiving XML messages. 

An embedded device may include a "thin" implementation of the XML messaging system as previously 
described herein that supports the specific set of messages for controlling and monitoring the simple embedded 
15 device. The implementation of the XML messaging system may be tailored for use wilh small footprint simple 
embedded devices, and thus may fit in the limited memory of the small footprint devices. In one embodiment the 
XML messaging system may be implemented in a small footprint with a virtual machine targeted at small footprint 
embedded devices (e.g. KVM). A networking stack (to support the transport protocol for communications with one 
or more control systems) may be associated with the virtual machine and the XML messaging layer may "sit on top" 
20 of the networking stack. It is noted mat this implementation of the messaging system may be used in other devices 
than small footprint or embedded devices. 

In one embodiment static or pre-generated messages may be used for requests from control systems to 
embedded devices. The static messages may be precompiled and stored in the embedded devices. An incoming 
message may be compared with the stored static messages to find a match for toe message and thus to perform the 
25 function requested by toe message, thus reducing or eliminating the need for code to parse mcoming messages. 
Outgoing messages may be read directly from the stored static messages, thus reducing or elinunating the need to 
dynamically compile outgoing messages. Thus, static messages may be used to reduce the code footprint of the 
messaging layer in embedded systems. For example, static Java objects(Java op codes) may be used forrequestand 
status messages. 

30 Figure 40a illustrates an embodiment of embedded devices 1804a and 1804b controlled by a control system 

1800, aceording to one embodiment Control system 1800 may be networked with the devices 1804a and 1804b it 
controls in any of a variety of ways. The network 1810 may be wired (Ethernet coaxial, twisted pair, power grid, 
etc.) and/or wireless (IrDA, microwave, etc.). In one embodiment embedded devices 1804a and 1804b may include 
a thin implementation of the XML messaging system for communicating with control system 1800 over network 

35 1810. Control system 1800 may have an implementation of toe XML messaging system for sending requests to and 
receiving responses from embedded devices 1804a and 1804b. In one embodiment control system 1800 may 
inctude software and hardware configured to present an interface to allow a user to display the status of and 
remotely- control the embedded devices 1804a and 1804b. In one embodiment control system 1800 may include 
software and/or hardware for automatic control of embedded devices 1804a and 1804b. 
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In one embodiment, embedded devices 1804a and 1804b may be part of another environment The 
devices may not support the message passing model implemented by the distributed network environment For 
example, the devices may be nodes in a networked automation and control system such as a LonWorks network. 
Control system 1800 may include a control system hardware and/or software for controlling devices in the other 
5 environment Control system 1800 may serve as a bridge between the distributed computing environment and the 
other environment The distributed computing environment may also provide a method or methods to wrap existing 
device discovery protocols for discovering the devices for access from the distributed network environment 
Bridging and wrapping protocols are further described herein in the Bridging section. 

Control system 1 800 may be connected remotely or locally to one or more other systems in the distributed 
10 computing environment Figure 40a shows control system 1800 connected to client 1806 via the Internet 1802. 
Client 1806 may indirectly request the state of; and send control requests to, embedded devices 1804a and 1804b 
through control system 1800. Thus, control system 1800 may serve as a proxy or bridge for embedded devices 
1804a and 1804b. See the Bridging section herein. To enable sophisticated communication between the client 1806 
and the control system 1800, the client and the control system may have different implementations of the XML 
15 messaging system than the thin irnplementation on the embedded devices 1804a and 1804b. In one embodiment, 
client 1806 may include software and hardware configured to present an interface to allow a user of client 1806 to 
display the status of and remotely control the embedded devices 1804a and 1804b. In one embodiment, client 1806 
must present the correct authorization credentials to control system 1800 to enable the client 1806 to access 
embedded devices 1804a and 1804b. In one embodiment, client 1806 may be granted access at different levels. For 
20 example, client 1806 may only be able to view the status of embedded devices 1804a and 1804b but not be allowed 
to remotely control the devices. In one embodiment, control system 1800 may be a service, may have a service 
advertisement published in the distributed computing environment, and thus may be accessed by client 1806 using 
the client-service method as described previously in this document In one embodiment, client 1 806 may be able to 
view the status ofj and to remotely control, control system 1800. 
25 Figure 40b illustrates client control system 1808 connected via the Internet 1802 to embedded devices 

1804c and 1804d, according to one embodiment In one embodiment, embedded devices 1804c and 1804d may 
include a thin implementation of the XML messaging system for communicating with client control system 1808 
over the Internet 1 802. Client control system 1 808 may have an implementation of the XML messaging system for 
sending requests to and receiving responses from embedded devices 1804c and 1804& In one embodiment, client 
30 control system 1808 may include software and hardware configured to present an interface to allow a user to display 
the status of and remotely control the embedded devices 1804c and 1804d. In one embodiment, client control 
system 1800 may include software and/or hardware for automatic control of embedded devices 1804c and 1804d 

A difference between Figure 40a and Figure 40b is that, in the embodiment ffiustrated in Figure 40b, me 
embedded devices 1804c and 1804d may be accessed by one or more clients in the distributed computing 
35 environment without requiring a proxy (e.g. control system). Embedded devices 1804c and 1804d may include 
services for accessing the functionality of the devices, may have published service advertisements in the distributed 
computing environment, and thus may be accessed via the client-service method as described previously in mis 
document 

The distributed computing environment may include a mechanism for a resource-limited client to retrieve 
40 Universal Resource Identifier (URI) addressed resources. For example, a client that is only capable of sending and 
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receiving messages via an IrDA connection may not be able to establish a URI connection to retrieve results from a 
results space. In one embodiment, a service may be provided as a bridge between the client and the URI resource. 
The bridge service may interact with the client via XML messages to gamer input parameters. The following is 
included as an example of XML input message syntax and is not intended to be limiting in any way: 
<type name== ? 'HttpGet w > 

<element name="urlstring" type="string"£> 

</type> 

Then, outside the distributed cornputing environment, the bridge service may establish a URI connection 
and retrieve the resource. The resource may then be encapsulated as a payload in one or more XML messages and 
sent to the client by the bridge service. 

The following illustration of one possible use of embedded devices with thin implementations of the XML 
messaging system is included for exemplary purposes and is not intended to be limiting . A building may include a 
plurality of electronic devices that consume energy (e.g. lights, air conditioners, office equipment), and thus may 
require a system for mamtaining an optimum energy consumption leveL The plurality of devices may each include 
an embedded device for controlling the electronic devices. The embedded devices may include the thin 
implementation of the XML messaging system. One or more control systems may be coupled to the devices in a 
network, for example, a building LAN or even the Internet A control system may store and execute a building 
management software package and an implementation of the XML messaging system configured to be used by the 
software package for monitoring and controlling the devices. The control system may accept input from users, and 
may display and otherwise output status information for the building energy consumption system, including status 
information for each of the plurality of devices. Energy consumption may be monitored by receiving XML status 
messages from each of the plurality of devices. When energy consumption levels need to be adjusted, XML control 
messages may be sent to one or more of the devices to cause the energy consumption to change. 

Implementing Services 

In one embodiment, the distributed computing environment may provide a mechanism for implementing 
services as servlets. The mechanism may provide functionality for developing services for the distributed 
computing environment 

In one embodiment, an Application Programming Interface (API) may be provided mat provides the 
functionality to allow the service to be initialized and registered in a space. In one embodiment, the API may 
be used to invoke the initiahzation of the service and to generate an initialization status page, for example, an 
HTML page, mat may define the status of the service. A user may access the status of the service by accessing the 
status page from a browser. In one ernbodiment, the API may be used to process incoming messages and to 

generate documents in response to the messages. 

An embodiment of the servlet mechanism may provide several functions including, but not limited to: 

• Management of the client connection to the service (unique session ID) 

• Management of an activation space that may be used to store results advertisements 

• Management of leases on connections sessions and results in activation spaces 

• Garbage collection of sessions and results 
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• Authentication of clients 

• Generation of client capabilities on a per session basis 

In one embodiment, the distributed computing environment may provide a service cascading mechanism by which 
new, complex services may be constructed from other existing services. For example, from a JPEG-to-PostScript 
transformation service and a print service, combining the transformation and print service may create a third 
cascaded service. In one embodiment, two or more services may be combined into a complex service by defining 
access methods of the two or more services as the access methods of the cascaded service. The following service 
advertisement for a cascaded service is included for exemplary purposes 
and is not intended to be limiting in any way: 

<Service> 
<name>Complex ServicednamO 
<DD>... </H» 

<description> .... </description> 

<AccessMethod> 

<AccessMethod> 

<ftame>com.traiiscode. jpg2psdname> 

<implementauori>http://vvw^ 
<AccessMethod> 
<AccessMethod> 

<name>com.prmter.f^Print<^name> 

<miplementation>bttp-y/www.^ 
</AccessMethod> 
</AccessMethoo> 

</Service> 
Conclusion 

Various embodiments may further include receiving, sending or storing instructions and/or data 
implemented in accordance with the foregoing description upon a carrier medium. Generally speaking, a carrier 
medium may include storage media or memory media such as magnetic or optical media, e.g., disk or CD-ROM, 
volatile or non-volatile media such as RAM (e.g. SDRAM, RDRAM, SRAM, etc), ROM, etc. as well as 
transmission media or signals such as electrical, electromagnetic, or digital signals, conveyed via a communication 
medium such as network and/or a wireless link. 

Various modifications and changes may be made as would be obvious to a person skilled in the art having 
the benefit of this disclosure. It is intended mat the invention embraces all such modifications and changes and, 
accordingly, the specifications, appendices and drawings are to be regarded in an illustrative rather than a restrictive 
sense. 
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WHAT IS CLAIMED IS: 

L A method for accessing a service in a distributed computing environment, comprising: 
a client locating a first service within the distributed computing environment; 

the client requesting a capability credential to allow the client access to a portion of the first service's 

capabilities, wherein said requesting a capability credential comprises the client indicating a set of 

desired capabilities; 
the client receiving said capability credential, v^erem ^ 

the right to use said portion of the first service's capabilities; and 
the client using said capability credential to access one or more of said portion of the first service's 

capabilities. 

2. The method as recited in claim 1, wherein said requesting a capability credential comprises the client 
sending a capability credential request message, wherein said capability credential request message comprises an 
identification of said first service and an mdication of me set of desired capabiliti^ 

3. The method as recited in claim 2, wherein said identification of said first service comprises a Universal 
Unique Identifier (UUID). 

4. The method as recited in claim 2, wherein said capability credential request message if formatted in 
extensible Markup Language (XML). 



5. The method as recited in claim 2, further comprising: 

the client receiving an advertisement for the first service, wherein said advertisement describes the portion 
£ of me first service's capabilities; and 

wherein said indication of the set of desired capabilities comprises an indication of said advertisement 

6. The method as recited in claim 5, wherein said indication of said advertisement is said advertisement itself! 

30 7. The method as recited in claim 5, wherein said indication of said advertisement is a Uniform Resource 
Identifier (URT) to said advertisement 

8. The method as recited in claim 5, wherein said advertisement describes all of the first service's capabilities, 
and wherein said indication of said advertisement in said capability credential request message in a version of said 

35 advertisement edited to describe only said set of desired capabilities. 

9. The method as recited in claim 5, wherein said advertisement is a protected advertisement that describes 
the first service's capabilities but does not provide an interlace to the first service's capabilities. 
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10. The method as recited in claim 1, former comprising: 

the client receiving a protected advertisement for the first service, wherein said protected advertisement 
indicates an address for sending said capability credential request message to; and 

wherein said requesting a capability credential comprises the client sending a capability credential request 
message to said address indicated in said protected advertisement 

11. The method as recited in claim 10, wherein said address indicated in said protected advertisement is for an 
authentication service, wherein said sending a capability credential request message . comprises sending said 
capability credential request message to said authentication service, the method further comprising the 
authentication service sending a credential request response message to the client in response to said capability 
credential request message. 

12. The method as recited in claim 1 1, wherein said credential request response message includes said 
capability credential, wherein said receiving said capability credential comprises receiving said capability credential 
from said authentication service in said credential request response message. 

13. The method as recited in claim 1, further comprising: 

the client receiving a protected advertisement for the first service, wherein said protected advertisement 

indicates an authentication service; and 
wherein said requesting a capability credential comprises the client requesting a capability credential from 

said authentication service. 

14. The method as recited in claim 13, the method further comprising: 

said authentication service determining a level of the first service's capabilities that the client is authorized 
to use; 

said authentication service generating said capability credential according to said level and said set of 
desired capabilities; and 

said authentication service sending said capability credential to the client, wherein said portion of the first 
service's capabilities mat said capability credential indicates that the client has a right to use is no 
more man said set of desired capabilities. 

15. The method as recited in claim 14, wherein said portion of the first service's capabilities , that said 
capability credential indicates that the client has a right to use is the lesser of said level of the first service's 
capabilities that the client is authorized to use and said set of desired capabilities. 

16. The method as recited in claim 1, wherein said using said capability credential to access one or more of 
said portion of the first services capabilities comprises the client sending a message to the first service to access a 
first capability, wherein the message includes said capability credential, the method further comprising the first 
service authenticating said capability credential received in the message to verify that the client has the right to use 
said first capability. 
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17. A client device, comprising: 

a connection to a distributed computing environment; 

an interface coupled to said connection and configured to locate a first service within the distributed 
computing environment; 

5 wherein the interface is further configured to request over the connection a capability credential for a set of 

desired capabilities to allow the client on the client device access to a portion of the first service's 
capabilities; 

wherein the interface is further configured to receive over the connection said capability credential, wherein 
said capability credential indicates that the client has the right to use said portion of the first 
10 service's capabilities; and 

wherein the mterface is further configured to use said capability credential to access one or more of said 
portion of the first service's capabilities, 

18. The client device as recited in claim 17, wherein the interlace is configured to request a capability 
15 credential by sending a capability credential request message, wherein said capability credential request message 

comprises and identification of said first service and an indication of the set of desired capabilities. 

19. The client device as recited in claim 18, wherein said identification of said first service comprises a 
Universal Unique Identifier (UUID). 

20 

20. The client device as recited in claim 18, wherein said capability credential request message if formatted in 
extensible Markup Language (XML). 

21. The client device as recited in claim 18, wherein the interface is further configured to receive an 
25 advertisement for the first service, wherein said advertisement describes the portion of the first service's capabilities, 

and wherein said indication of the set of desired capabilities comprises an indication of said advertisement 

22. The client device as recited in claim 21, wherein said indication of said advertisement is said advertisement 
itself 

30 

23. The client device as recited in claim 22, wherein said indication of said advertisement is a Uniform 
Resource Identifier (URI) to said advertisement 

24. The client device as recited in claim 21, wherein said advertisement describes all of the first service's 
35 capabilities, and wherein said indication of said advertisement in said capability credential request message in a 

version of said advertisement edited to describe only said set of desired capabilities. 

25. The client device as recited in claim 21, wherein said advertisement is a protected advertisement that 
describes the first service's capabilities but does not provide' an interface to the first service's capabilities, 
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26. The client device as recited in claim 17, wherein the interface is further configured to receive a protected 
advertisement for the first service, wherein said protected advertisement indicates an address for sending said 
capability credential request message to, and wherein the interlace is configured to request a capability credential by 
sending a capability credential request message to said address indicated in said protected advertisement 

27. The client device as recited in claim 26, wherein said address indicated in said protected advertisement is 
for an authentication service, wherein said sending a capability credential request message comprises sending said 
capability credential request message to said authentication service. 

28. The client device as recited in claim 27, wherein the interface is configured to receive said capability 
credential from said authentication service in a credential request response message. 



29. The client device as recited in claim 17, wherein the interface is farther configure to: 

receive a protected advertisement for the first service, wherein said protected advertisement indicates an 
15 authentication service; and 

request a capability credential by requesting a capability credential from said authentication service. 

30. The client device as recited in claim 29, wherein said portion of the first service's capabilities that said 
capability credential indicates that the client has a right to use is the lesser of said level of the first service's 

20 capabilities that the client is authorized to use and said set of desired capabilities. 

3 1. The client device as recited in claim 17, wherein the interface is configured to use said capability credential 
to access one or more of said portion of the first services capabilities for said client by sending a message to the first 
service to access a first capability, wherein the message includes said car^ility credential so that the first service 

25 may authenticate said capability credential received in the message to verify that the client has the rigjit to use said 
first capability. 

32. The client device as recited in claim 17, wherein said interface comprises one or more processes executable 
on a processor within the client device. 

30 

33. A carrier medium comprising program instructions, wherein the program instructions are computer- 
executable on a client device to implement 

locating a first service within the distributed computing environment; 

requesting a capability credential to allow a client on the client device access to a portion of the first 
35 service's capabilities, wherein said requesting a capability credential comprises the client 

mdicating a set of desired capabilities; 
receiving said capability credential, wherein said capability credential indicates that the client has the right 

to use said portion of the first service's capabilrtiesj and 
using said capability credential to access one or more of said portion of the first service's capabilities. 
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34. The earner medium as recited in claim 33, wherein said requesting a capability credential comprises the 
client sending a capability credential request message, wherem sdd capability credential 
an identification of said first service and an indication of the set of desired capabilities . 

5 35. The carrier medium as recited in claim 34, wherein said identification of said first service comprises a 
Universal Unique Identifier (UUID). 

36. The carrier medium as recited in claim 34, wherein said capability credential request message if formatted 
in extensible Markup Language (XML). 

10 

37 The carrier medium as recited in claim 34, wherein the program instructions are computer-executable on 
the client device to further implement 

receiving an advertisement for the first service, wherein said advertisement describes the portion of the first 
service's capabilities; and 

15 wherein said indication of the set of desired capabilities comprises an indication of said advertisement 

38. The carrier medium as recited in claim 37, wherein said indication of said advertisement is said 
advertisement itself 

20 39. The carrier medium as recited in claim 37, wherein said indication of said advertisement is a Uniform 
Resource Identifier (URI) to said advertisement. 

40. The carrier medium as recited in claim 37, wherein said advertisement describes all of the first service's 
capabilities, and wherein said indication of said advertisement in said capability credential request message in a 

25 version of said advertisement edited to describe only said set of desired capabilities. 

41. The carrier medium as recited in claim 37, wherein said advertisement is a protected advertisement that 
describes the first service's capabilities but does not provide an interface to the first service's capabilities. 

30 42. The carrier medium as recited in claim 33, wherein the program instructions are computer-executable on 
the client device to further implement 

receiving a protected advertisement for the first service, wherein said protected advertisement indicates an 

address for sending said capability credential request message to; and 
wherein said requesting a capability credential comprises the client sending a car^iliry credential request 
35 message to said address indicated in said protected advertisement 

43. The carrier medium as recited in claim 42, wherein said address indicated in said protected advertisement 
is for an authentication service, wherein said sending a capability credential request message comprises sending said 
capability credential request message 
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44. The carrier medium as recited in claim 43, wherein said receiving said capability credential comprises 
receiving said capability credential from said authentication service in a credential request response message. 

45. Hie carrier medium as recited in claim 33, wherein the program instructions are computer-executable on 
5 the client device to further implement 

receiving a protected advertisement for the first service, wherein said protected advertisement indicates an 
authentication service; and 

wherein said requesting a capability credential comprises the client requesting a capability credential from 
said authentication service. 

10 

46. The carrier medium as recited in claim 45, wherein said portion of the first service's capabilities that said 
capability credential indicates mat me client has a right to use is the lesser of said level of the first service's 
capabilities that the client is authorized to use and said set of desired capabilities. 

15 47. The carrier medium as recited in claim 33, wherein said using said capability credential to access one or 
more of said portion of the first services capabilities comprises the client sending a message to the first service to 
access a first capability, wherein the message includes said capability credential so that the first service may 
authenticate said capability credential received in the message to verify that the client has the right to use said first 
capability. 

20 
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